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INTRODUCTION 


This reference manual is intended to explain the utilization of the "SFG-05 
Control Program version 2.0" which resides within the internal 32Kbyte 
ROM of the "SFG-05"- 

All the explanations for the chord-key function, auto-bass function, and 
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CHAPTER 1 Outline 
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1-1 Program Configuration 


The basic configuration of this program (SFG-05 Control Program) 
follows that depicted in the following figure. 

The M-B10S (Music Bios) controls the hardware of the SFG-05. 

As a tool box, it provides the user various basic I/O modules 
(MBIOS) and utilities required for instrumental sound sysnthesis 
and music processing. 

With the use of MBIOS modules, parameter handling for sound 
synthesis and computer music performance can be carried out 
without any necessity for the user to directly access the hardware 
of the SFG-05. 

Additionally, MBIOS includes several built-in utilities. If used, 
these will provide convenient supplementary services to the user 
that would otherwise have to be programmed by the user. 

These utilities are: 

1) Reocording of performance and playback 

2) Loading/saving of voice/automatic performance data 
onto CMT(Cassette Magnetic Tape recorder) 

3) BDOS call entry(with the provision of IRQ handling and 
slot management) 

In SFG-05, MBIOS functions can be invoked under three operating 
modes. They are operating mode 1.0, 1.1, and 2.0. 

Operating mode 1.0 is compatible to MBIOS of SFG-01. That is, all 
the MBIOS functions work using filed address working area under 
the interrupt mode 1. Bugs found in SFG-01 are now corrected in 
operating mode 1.0. 

In operating model.1, the base address of MBIOS working area can 
be allocated anywhere in available RAM. This enables MBIOS to 
run under disk environment. However, in the operating mode 
1.1, interrupt mode of Z80 is still assumed to be under model 

In operating mode 2.0, the base address to MBIOS work is not only 
relocatable, but interrupt mode is also assumed to be under mode2. 
This allows disk access and the fast interrupt handling of MIDI 
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caused by SFG-05 cartridge. For fast MIDI data handling, FIFO 
buffer handling for transmitter and receiver function is now added 
to the operating mode 2.0. 


The M-Monitor (Music Monitor ) is a demonstration program that 
converts the MSX computer into a synthesizer, and will operate on 
MBIOS. M-Monitor can be invoked from BASIC, by issuing “CALL 
MUSIC'. 

The M-Monitor can be invoked either from the operating mode 1.0 
or from the operating mode 2.0, respectively from the different 
entry. 

If called as M-Monitor 1.0, it will not support disk functions. 



User Application 
Programs 


New 

M-MOnitor 


MBIOS 1.0 

MBIOS 1.1 

MBIOS 2.0 

FIXED 

WORK 

RELOCATABLE 

WORK 

IRQ-MODE 1 

IRQ-MODE 2 


iiiiSFG hardware! I 


FIG 1.1 MBIOS CONFIGURATION 
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1-3 Hardware Configuration 


The configuration of the hardware is shown in the following figure. 

The MSX main unit and the SFG-05 are connected together by the 
60-pin cartridge bus. 

50 pins out of the 60-pins form the standard MSX bus, and the 
remaining 10 pins are not in use in the SFG-05. 

Additionally, the right channel of the SFG-05 is equipped with a 
low pass filter with a cut-off frequency around 3-5 KHt 
The filter is enabled when CSM vocal synthesis is invoked, for CSM 
vocal synthesis is carried out only on the right channel. 



TO CPU BUS 



BOIR 


FIG. 1.2. HARDWARE CONFIGURATION OF SFG-05 
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1-4 Interface With MSX-BAS1C 


(Header] 


The first 16 bytes starting from Address 4000h of MBIOS is a 
header to enable the MSX-BASIC to jump to the Music-Monitor 
of MBIOS. 


4000h (ID) 

4002h (INIT) 

4004h (STATEMENT) 
4006h (DEVICE) 
4008h 

400Ah and up 


(VDP reseting] 


"AB- 

Address of RETURN instruction 

Address of "CALL MUSIC 

OOOOh 

OOOOh 

OOOOh 


During CSM vocal synthesis and in the operating mode 2.0, 
IRQ from VDP is reset directly. 


(PLAY queue-buffer usagel 


MBIOS uses PLAY-queue buffer area as an indirect addressing 
pointer buffer. 

Therefore when MBIOS is active, MBIOS alters the PLAY-hook 
so as the PLAY-queue buffer not to be referenced accidentally 
by BASIC's PLAY routine. 

PLAY-queue buffer usage is: 

MBIOS —- F975h - F9F4h 

M-MONITOR- F9F5h-FAF4h 
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1-4 Interface With MSX-BASIC 


iHeader] 


The first 16 bytes starting from Address 4000h of MBIOS is a 
header to enable the MSX-BASIC to jump to the Music-Monitor 
of MBIOS. 


4000h (ID) 

4002h (INIT) 

4004h (STATEMENT) 
4006h (DEVICE) 
4008h 

400Ah and up 


IVDP resetingl 


"AB" 

Address of RETURN instruction 

Address of "CALL MUSIC 

OOOOh 

0000b 

OOOOh 


During CSM vocal synthesis and in the operating mode 2.0, 
IRQ from VDP is reset directly. 


(PLAY queue-buffer usage] 


MBIOS uses PLAY-queue buffer area as an indirect addressing 
pointer buffer. 

Therefore when MBIOS is active, MBIOS alters the PLAY-hook 
so as the PLAY-queue buffer not to be referenced accidentally 
by BASIC's PLAY routine. 

PLAY-queue buffer usage is: 

MBIOS - F975h - F9F4h 

M-MONITOR- F9F5h - FAF4h 
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1-5 Versions 


This program contains a 9 byte version code from address 0080h. 


0080h: 

"MCHFMO" 

Program ID code 

0086h: 

08h 

ROM serial * 

0087h: 

OOh 

FM sound chip type 

0088h: 

lOh 

software version * 


For the identification of either SFG-01 or SFG-05. it is only 
necessary to look for the first 6 byte code "MCHFMO" from address 
0080h. 

However, the contents of address 0088h provide the information 
for the type of SFG. 

For SFG-01, (0088h)=00h - OFh: 
for SFG-05, (0088h)=10h and up. 



October 16,1985 


Chapter II 


Basic Functions 
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2-1 Instrument, Queue, and Keyboard 


The Instrument, queue, and keyboard form the fundamental 
structure of M-B10S. 

The following illustration depicts the relationship of these three 
main functional units. 

(Instrument) 

Instrument is depicted at the rightmost portion of the figure. 

The instrument is meant to be an event processing system. 

It processes the incoming event requests to realize the musical 
performance such as playing melody. 

The instrument is defined by a control block called IDB 
(Instrument Definition Block). 

There are up to 8 instruments that can be defined with IDB with 
IDB'O to IDB#7. 

Each IDB can be assigned with 1 to 8 cahnnel resources of FM 
sound LSI. Channel assignement is dynamically performed for 
each instrument by MBIOS. This way, as long as total channel 
resources of FM LSI does not eiceed the maiumum of 8, the user 
of the MBIOS can define as many as 8 different instruments with 
any number of channels (between 1 and 8) linked up with each 
instrument. 

(Queue) 

In the middle ofthe figure, Queue is depicted. 

This functional module arts as processing buffer between input 
(events) and the next functional module, called Instruments. 

There are 8 queues that can be used by the instruments. 

Queues are numbered from QU'O to QU # 7. 

(Keyboard) 

In the figure, the keyboard is an input to the music processing 
system. It issues key-on/ofT requests and associated velocity 
inputs. Since the requests are time dependent, they are called 
events. 

MK a music trevhoard attached to SFO-flS unit is one of the 
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keyboards. 

Any automatic performance process provided by the user could 
also be categorized as a keyboard since it issues events to the 
system as veil. 



[KEYBOARD] 


[QUEUE] 


[INSTRUMENT] 
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IIDB and Event] 


Related SV-calls: 
S-00 
S-09 
S-OA 
S-OB 
S-12 
R-00 


R-01 

R-02 

P 


define IDB 
assign channel 

assign IDB to queue and/or MIDI channel 
All-Note-Off by IDB 
define play-mode 

Damp (issue All-Note-OfT to all queues and 
damp all the currently engaged voices to 
channels) 

All-Note-Off by queue 
set event into queue 
play 


(Event) 

The instrument is the most important functional unit in MBIOS. 

It is defined by a 128 byte control block called IDB. Service call 
S-00 is used to define IDB. 

The IDB contains the information of the run-time parameters for 
the performance, as veil as the preset data for the FM sound chip. 
The IDB should also be assigned with the channels usage of the FM 
sound LSI. This is done by S-09. 

Input to IDB is event data. The event buffer called queue, should 
be linked to the IDB. To do this, S-OA call is used. 

The event data is fed to the queue in the form of argument to R-02 
service call (All-Note-Off event is however issued as the service 
call R-01). The events are then retrieved and processed by the 
P-Call from the single linked Queue to the IDB. 

There are three events: Note-on, Note-off, and All-Note- off. 
Note-on and Note-off are each comprised of 2 bytes of data. 
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15 


876 543210 


NOTE ON 


KC * 


VELOCITY 


15 


876 543210 


NOTE OFF 


m 

KC • 

o 

o 

0 

0 

0 

0 

0 

0 


ALL MOTE OFF (NO DATA) 


KC*OCeycode number) indicates an 8-octave range, with the note 
name being represented by the lower 4 bits, and the octave by the 
upper 3 bits. This KC B format is internal to SFG-05 as shown in the 
following. 

7 6 5 4 3 2 10 


KC* 


OCTAVE 


MOTE NAME 


<0h> C* 

<8h>6 

<1h> D 

<9h>G* 

<2h> D* 

<Ah> A 

<3h> - 

<8h> - 

<4h> E 

<Ch> A* 

<5h> F 

<Dh> B 

<6h> F* 

<Eh> C 

<7h> - 

<Fh> - 


{Event output to MIDI) 


When the events are transmitted from MIDI interface, they are 
packed into the standard MIDI message format with MIDI 
destination channel number, MIDI-KC*, and MIDI-velocity. 

They are as following: 
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NOTE-ON 76 543210 


7 

7 

o 

3 

MIDI * 

0 

MIX* 

0 

MVELOCITY 


NOTE-OFF 76 543210 


1 

loo 

71 

MIDI * 

0 

MKC* 

0 

'HBl 

oloj 

0 

0 

0 


7 

6 

5 

4 

3 

2 1 

0 

D 

□ 

n 

D 

MMM 

□ 

n 

□ 

□ 

□ 

□□ 

□ 

a 

□ 

a 

El 

a 

□□ 

□ 

D 

□ 

D 

a 

MIDI * 

□ 

n 

D 

D 

a 

□D 

D 

□ 

□ 

□ 

a 

□ 

EH3 

El 


Where MIDI* is a destination MIDI channel. 

MIDI*=0 - 15 for midi channel * 1 to 16 .respectively. 

MKC* and MVelocity stand for KC» and Velocity in MIDI format, 
respectively. 

[difference between MBIOS event format and MIDI format) 

User is advised to note the difference between MBIOS event format 
and MIDI data format. 

While the SFG-05 internal KC* looks as shown before, the MIDI KC* 
is a linearly arranged number, with OOh being the lowest note 
and 7fh the highest note. 

Some examples between internal format and that of MIDI are 
depicted here: 


Note 

C»0 


Internal KC* 
OOh 


MIDI format KC* 
ODh 
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A4 4Ah 45h 

C7 7Eh 6Ch 


Also observe that MB10S velocity is different from MIDI velocity 
format. 

The SFG-05 internal velocity code covers an 8-bit range between 
OOh (Minimum) and FFh (Maximum). 

MIDI velocity can be derived from MBIOS velocity format by 
dividing it by 2. 


(channel assignemnet) 

In event processing of IDB's, users are advised to note the 
following consideration. 

MBIOS performes special processing when channels alloted to the 
IDB are all in use and still there is a request to the channel of that 
IDB. 

That is, the FM sound generator IC has 8 channels (8 notes), out of 
which as many as desired up to the maximum of 8 channels can be 
allocated to IDB. However, when the request for note-on events 
exceed the available channels declared in IDB, the processing will 
differ depending on whether only one channel is being used, or if 
two or more channels are being used. 

1) When only one channel is being used, and if the second note-on 
request is issued while the first note is still on. then the second 
note-on is granted, stopping the first note and pushing it into the 
stack. 

Then, the note-off of the second key will enable the first key to be 
popped back and keyed on againf two level stacking system). 

2) When two or more channels are being used, and if the last 
note-on request is made while all 8 channels are used up, the first 
note will simply be keyed ofT, and the last one will be granted. 
Stacking will not occur (last note priority system). 



l> 

IRQ 

HANDLER 



USER'S PERFORMANCE ROUTINE 


FM CHIP 


MIDB 


EYE NT 
DATA 


QUEUE 


:put event;!; 

ALL-NOTE-OFF 


CHANNEL 

•iiMAP; •; 


;S09,0A,0B: 

: : : : S- 12 : ! : i 

;; assign ;;; 
channel,e'tc 

i : DEFINE IDB 


■: R- 18J: 
LOAD LFO 


MIDB VAR 


/S-14 : 
OAD VOICE 


CURRENT 

YOICE 


USER'S PARAMETER 
: LOADING ROUTINE; 


GET VOICE 


CHOSEN 

VOICE 


USER'S SET-UP ROUTINE 
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[Queue] 


Related SV-calls: 


R-00 Damp 

R-01 All-Note-OfT by queue 

R-02 set event into queue 


Queue is a process to handle the queue buffer that is capable of 
accepting up to a maximum of 16 events. 

There are queue's for 8 general events (QU°0, _ , QU*7). 

Queue's are named as QU°i, and refered as. 

QU»x 

0 thru 7 QU # 0 thru QU»7 
(QU numbers between 8 and 15 are reserved for future 
use). 

Queue's primary function is to buffer the event flows between the 
keyboard and the process of playing IDB. 

It ensures the asynchronicity of two independent processes 
(keyboard handling and playing IDB's) running simultaneously in 
the program space. Working as a FIFO, this effectively increases 
the data processing rate without having to miss the note or 
seriously delay the performance timing. 

The Queue also merges the event data from a multiple number of 
keyboards, and distributes them to a multiple number of IDB's that 
are linked to a queue. 

The AU-note-off event erases presently queued events from the 
queue , and sets the All-note-off flag in the queue. 




October 16, 1985 


Keyboard) 


Tbe keyboard is, in effect, the event generator. 

The external keyboard attached to the SFG-05 (MK) is a music 
keyboard. 

An automatic performance buffer is treated as a music keyboard, 
too. 

For “keyboards", like MK or automatic peformance buffer, events 
are then input to QU*0-QU*7. 


(Music Keyboard! 


Related SV calls: 


K-00 initialize MK 

K-01 scan MK 

K-02 report MK status 

AST-01 MK trigger by asynchronous trap 

M-BIOS supports a 49 key keyboard. 

It is as shown below. It is used as the mounted keyboard (MK). 


MK ONLY 



LOWEST KEY (49 KEYS) 
KC*=1 EH (INTERNAL) 


KC*=5EH(INTERNAl) 

54H(MIDI) 


=24H(MIDI) 
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The MK can only be linked with Queues, QU*0 - QU"7. If this is 
done, M-B10S will register all events sent by MK into the linked 
Queue. 
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2-2 Performance parameters for the instrument (IDB) 


[Portamento! 


Related SV-calls & memory reference: 

S-12 define play-mode 

R-19 load KC 

i.port IDB(w)/portamento speed 

m.dka MIDB(w)/clock-A interval 

This is applicable to only single voiced IDB (IDB assigned with one 
channel). 

Portamento mode can be enabled via S-12 call, together with 
appropriately set portament parameters into IDB. 

The method to implement portamento requires repeated updates 
of KC with specified parameters. To do this, R-19 call (to update 
KC with specified pitch increments and load it into channel) should 
be called by an appropriate ,say interrupt clock-A, interval. 

The Portamento Speed determines the rate of pitch shift during the 
portamento, with the Speed=0 being equivalent to no portamento 
effect at all. 

There are two Portamento Modes, Full Portramento and Fingered 
Portamento. 

In Full Portamento, the Portamento will take effect for any 
Note-on, and in Fingered Portamento, it will take effect only while 
key stacking is taking place. The stacking will take place when 
only one channel is assigned to the instrument, and when the first 
key still being pressed is pushed onto the stack by the second key- 
on, or when the first key is popped out of the stack by the release 
of the second key. 

Though the portamento is normally modified by IDB variables, 
since MBIOS executes the portamento by using Clock-A of the 
sound generator IC, changing the CLOCK-A interval value in MIDB 
from the initial setting (8000h) will also cause the portamento 
speed to change. 





December 3, 1985 


ITrigger Typel 


Related SV-call: 

S-12 define play-mode 

Applicable only to single voice IDB. 

The trigger type can be determined by using the Trigger Mode (set 
by S-12 call). 

By trigger, we mean that the envelope is generated from the very 
beginning at the key-on request. 

A trigger will be generated for every Note-on event during the 
MULTI Trigger mode. However, in the case of a single channeled 
instrument, it is possible not to generate a trigger but to change 
only the pitch during the key stacking. Thus the envelope 
continues as it is when the second key is on. This is called Single 
Trigger mode. 

ISustain Control] 


Related SV-call k memory reference: 

S-12 define play mode 

i.sust IDB(w)/sustain RR 

This is applicable to all IDB's. 

Sustain controls the release rate (RR) of the envelope after Note 
-off (mostly to lengthen the release time). 

When Sustain mode is off, the release rate for each operator will 
be computed according to RR of the voice as usual. However, if 
Sustain mode is on, MBIOS will output the Sustain rate (RR) 
contained in IDB to all the operators whose channels are involved 
in Note-off events. 

Thus , it is possible for the user to write his own Sustain handling 
routine under the Sustain mode by simply modifying the contents 
of Sustain rate of the IDB. 


I key code Sensible Range] 
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Related SV-call & memory reference: 

S-00 define 1DB 

i.krng IDB(w)/key code range by instrument 

It is possible to set the KC sensitivity range of the IDB, where only 
KC*'s within that range are only accepted. 

This function is useful to implement a register sensitive keyboard, 
such as split keyboard. 

Any deviation from this range in the Note-on event will not be 
accepted. However, the Note-off events are not limited in this 
manner. All-note-off events will be accepted and appropriate 
Note-off processing will be carried out. 

With All-Note-Off. since it is granted and performed regardless of 
the keycode range, the care must be paid when IDB is linked-up 
with MIDI device. For the MBIOS will issue All-Note-Off to the 
outside of the keycode range of MIDI device (where the events 
may not necessarily need to be turned off). 


(Transposition] 


Related SV-call & memory reference: 

S-00 define IDB 

R-19 load KC 

i.trns IDB(w)/transpose by instrument 

m.trns MIDB(w)/masler transposition 

There are 3 ways to realize transposition; the transposition of the 
entire system, the transposition of an individual IDB, and the 
transposition by means of altering voice data. 

Transposition of the entire system is obtained by modifying the 
Master Transpose variable in MIDB. 

Individual instruments can be transposed via the Instrument 
Transpose variable in the IDB. 

Note that transpositions by IDB or MIDB will only be realized by 
issuing R-19, for it is R-19 that loads the parameters to FM 
shynthesizer LSI from i.trns or m.trns. 

Transposition by voice data is a pitch-shift that has been 
preprogrammed in the voicing data by use of the YRM102 voicing 
program. The primary purpose of this feature is to include the 
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"pipe" length of the instrument (8',16',1 3/5',etc.) in the voicing 
parameters. 

When transposition via IDB is attempted for the IDB that has been 
enabled by pitchbend, the transposition will not be accessible by 
the user. 

This is because the pitch bend function uses the Instrumant 
Transpose function to accomplish pitch bend. 

[Pitch Bend] 


Related SV-calls & memory reference: 

S-ll set pitchbend 

R-19 load KC 

i.pchb IDB(w)/pitchbend depth 

Pitch bend is like a portamento function. 

When pitch bend parameter is handed to MBIOS via R-ll, it 
requires for KC to be updated and loaded into channel, with 
appropriate interval using R-19. 

Also Pitch Bend Depth by IDB is a single parameter used for the 
entire system so that it affects all the instruments with the same 
amount of pitch bend. 

The Pitch Bend Depth can be programmed from ♦/- 1 half tone to 
♦/- 1 octave with half-tone resolution. 


[Volume, Briliiancel 


Related SV-calls: 

S-10 set brilliance 

S-13 set volume 

Volume and Brilliance are both OL (Output Level) offsets, with 
Volume being the offset for the carrier, and Brilliance that for the 
modulator. 

Volume is a parameter that exists for every instrument, and can 
be adjusted for every carrier of the instrument. 

However, there is only a single Brilliance parameter within the 
entire system, and this is applied to only the Brilliance-enabled 





October 30, 1985 


modulators. 

The range of both Volume and Brilliance offsets against OL's is 
between 0 dB (MAX) and -48 dB (MIN). 


INoise] 


Related SV-cail & memory reference: 

R-18 load LFO 

mjiois MlDB(w)/noise frequency 

The 0PM has a noise generator which is started when operator 3 of 
channel 7 receives a key-on command. 

Noise parameter such as noise frequency (seed to generate random 
number) can be loaded into the channel via R-18. 

If the voicing parameter data that has been loaded into the channel 
7 has been noise-enabled, it will generate noise. 

ILFOJ 


Related SV-call and memory reference: 


S-18 

set AMS/PMS 

R-18 

load LFO 

m.lfo 

MIDB(w)/LF0 frequency 

m.amd 

MIDB(w)/AMD 

m.pmd 

MIDB(w)/PMD 

m.ctrl 

MIDB(w)/LF0 waveform 


The operation of the LFO is determined by the Speed, Waveform, 
AMD and PMD commands. 

Speed sets the frequency of the LFO. 

AMD sets the output level of the LFO for amplitude modulation, 
and PMD sets the output level of the LFO for pitch modulation. 

As depicted in the routing of the LFO, in the following figure, LFO 
outputs adjusted by AMD and PMD are common to all the 
instruments. 

Above items that are common to the system (in the MIDB) are 
loaded to the FM LSI chip by R-l 8 call. 
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AMS and PMS set the sensitivity to LFO modulation for each 
individual instrument. Note that AM (amplitude modulation) is 
only effective to the carriers of the current operator algorithm. 

The Triggered Sync function initializes the LFO phase to O(zero) in 
synchronization with Note-on events. 

AMS, PMS and Sync are voice data dependent parameters. 


c/m 
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2-3 Voice Library 


Related SV-calls: 
S-03 
S-14 
S-15 
S-16 
S-19 
S-21 
S-22 


define UVL 
load voice 
get voice 
put voice 
get and load voice 
read UVL 
write UVL 


Voice parameters used to simulate an instrumental sound are 
handled together and packed into 6-4 bytes of data (-48 bytes of 
data in the case of the system preset library). 

Its map is shown in the following page. 


The voice library holds these voice parameter sets. 

It has a capacity of 48 voices in MBIOS (called SVL, System Voice 
Library), and can be expanded to another 48 voice area in user 
RAM called as UVL (User Voice Library). 

Voices are refered to by number; 0 - 47 for SVL voices, and 64 to 
111 for UVL voices. Voice numbers 48 - 63 are reserved. 

Although it is possible to address all the voices, MBIOS assumes 
the following voices of SVL are special voices dedicated to special 
functions. 

That is; voices 36 - 39 for chord generation, voices 40 - 41 for 
bass note, voice 44 and 45 for percussion , are used by 
M-Monitor. 

Voice 46 is reserved for use by the CSM voice sysnthesis driver 
(IDB»CSM). 


The following is a directory of SVL. 


1 brass 1 

2 brass2 

3 trumpet 

4 string 1 

5 string 1 

6 epianol 


17 piccolo 

18 oboe 

19 clarinet 

20 glocken 

21 vibraphone 

22 xylophone 


33 lo string 

34 horn lo 

35 whisle 

36 storm 

37 rm.bass 

38 milt 
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7 

8 

9 

10 
11 
12 

13 

14 

15 

16 


epiano2 

23 koto 

39 rm.guit 

epiano3 

24 zither 

40 rm.horn 

guitar 

25 clav 

41 rl.bass 

ebassl 

26 harpsichord 

42 r2.bass 

ebass2 

27 bells 

43 snaredrum 

eorganl 

28 harp 

44 rd cymbal 

eorgan2 

29 smadsyn 

45 perc 1 

porganl 

30 harmonica 

46 perc 2 

porgan2 

31 steeldrum 

47 csm param 

flute 

32 timpani 

48 no voice 


MB10S is equipped with a Tile utility to save UVL and load it bacK 
to UVL using CMT, data cartridge, and the disk. 

In the following pages, the format of UVL is depicted with further 
breakdown of voice data format and detailed voice parameter 


map. 



UVL (USER VOICE LIBRARY) 
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VOICE DATA MAP 

Name 

Address 

Offset 

Contents 

Explanations 

v.name 

OOh 

[7 byte string] 

[name of the voice) 

v.type 

07h 

fuuuu 

I A7WVA A A A A 1 

{user code (any number)} 

v.lfo 

08h 

J 

(LFO frequency] 

O0h-0.0008HZ (slow) 

80h-0.2134Hz 

FFh*52.9Hz(fast) 

v.amd 

09h 

[xyyyyyyy] 

[LFO enable &. AMD) 
x-<1> enable to load LFO 
y«0-7Fh, deepest AMD 

v.pmd 

OAh 

[xyyyyyyy] 

[sync LFO & PMD] 
x=<l> sync LFO at key-on 
y-0-7Fh, deepest PMD 

v.slot 

OBh 

[Oxyz uOOO] 

[enable operator) 
x-<!> operator*! 
y-< 1 > operator *2 
z-<l> operator *3 
u-<1> operator *4 

v.cnct 

OCh 

[xyzz zuuu] 

[LR, feedback & algorithm) 
x-<1> stereo L output 
y-<l> stereo R output 
z-0-7 (0-4 pai) .feedback level 
u-O-7, algorithm number 

v.pms 

ODh 

[Oxxx OOyy] 

[pms and ams] 
x-0 +/- 0 cent (pms) 

X" 1 */- 5 cents 
x-2 ♦/- 10 cents 
x*=3 ♦/- 20 cents 
x-4 ♦/- 50 cents 
x-5 +/- 100 cents 
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x-6 

♦/- 

400 cents 

x-7 

♦/- 

700 cents 

y-0 

OdB (ams) 

y-1 

-24 

dB 

y-2 

-48 

dB 

y>3 

-96 

dB 


v.nois 

OEh 

Ixyyz zzzz] 

v.trns 

OFh 


operator 

v.tl 

*0 

♦OOh 

[0*xx *-***] 

v.vel 

♦Olh 

(xyyy OOOz] 

v.ks 

♦02h 

(xxxx yyyy] 

v.dtl 

+03h 

[-xyy zzzz] 


(noise/lfowave/noise freq.) 
x-<1> enable noise 
y»<00> sawtooth 
y-<01> rectangler 
y-<10> triangler 
y-<11 > sample and hold 
z - noise frequency 

(transposition by voice) 
-12700 cents to 12700 cents 
(2 s complement) 


(OL original level) 

0 dB to -95.25dB (by 0.75dB) 

(key level scaling & velocity) 
x-<0> typeO (low pass type) 
x«<l> type 1 (high pass type) 
y= velocity sencitivity 
carrier 0 to ♦-10.5 dB (1.5 dB) 
index 0 to ♦-5.25 dB (0.75dB) 
z*<l> enable brilliance 

(key level scaling depth, adj.) 
x- key level scaling depth 
0 to -22.5dB (by 1.5 dB) 
y* TL (total level adjust) 

0 to -11.25dB (by 0.75dB) 

(detune & multiple) 
x*<0> positive (up) detune 
x-<1> negative (down) detune 
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v.ar + 04h [xxOy yyyy] 


v.dlr +05h [xOOy yyyy] 


v.d2r *06h [xxxy yyyy] 


v.rr +07h Ixxxx yyyy] 


y- 0 - 3 detune value (max-3) 
z-multiple 
z-0 pitch*0.5 
z-1 pitch* 1 


z-15 pitch* 15 

(key rate scaling & attack rate] 
x- 0 - 3 (max(fastest rate)=3) 
y- 0 - 31 (max-31) 

(ams enable & decay rate-1] 
x-<0> disable ams (modulator) 
x-<1> enable ams (carrier) 

(detune-2 and decay rate-2] 

x=0 DT is *0 

x=l DT is *1.41 

x-2 DT is *1.57 

x=3 DT is *1.73 

y-0 - 15 decay rate-2(max= 15) 

(sustain level and release rate] 
x- 0 to 14 (0 to -42 dB by 3dB) 
x-15 (-93 dB) 

y»0- 15 release rate(max-15) 


operator * 1 

18h-1Fh 


operator *2 

20h-27h* 


operator *3 

28h-2Fh 


all O's 


30h-3Fh 








October 16, 1985 


2-4 Important Voicing Parameters 


Related SV-call: 

S-14 load voice 

S-19 get and load voice 


(Velocity! 


Velocity refers to the touch intensity at Note-on time (Initial 
Touch), and affects an offset level for the OL of each operator. 

The central value (80h) of the Velocity is used as the normal 
setting. 

When the Velocity increases, the volume gets louder if the carrier 
is sensitive to the velocity, and the sound gets brighter if the 
modulator is sensitive to the velocity. 

The Velocity Depth covers the effective range of the effect caused 
by Velocity. Depth is adjustable for the carriers over a range of 
+-12 dB, and +-6 dB for the modulators. 


(Envelope) 


The Envelope can be set independently for each operator. 
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ENVELOPE 


As shown here, the shape of the Envelope is determined by 
AR (Attack Rate), DIR (1st Decay Rate), D2R (2nd Decay Rate), RR 
(Release Rate), and by SL (Sustain Level) between the 1st Decay 
and 2nd Decay. 

OL (Output Level) offsets the standard level of envelope. 

The actual OL commanded in the FM sound generator IC is a sum 
total of such offsets as OL (original offset), OL Adj (adjusted ofTset 
for algorithm difference). Keyboard Scaling (Keyboard scaled 
offset). Velocity (Velocity offset) and Volume/Brilliance(offset due 
to volume or brilliance control). 

Note that all the ofTset amounts are in terms of attenuation from a 
0 dB standard. 

The offset range varies depending upon the purpose of usage. For 
example, OL (original offset) can be set over a range of 0 dB to 
-96dB, while OL Adj can be set over a range of 0 dB to -12 dB. 


IKeyboard Scaling] 


There are two types of keyboard scaling. 

One is for the rate( AR,D1R,D2R,RR) of the envelope. The keyboard 
rate scaling is carried out by hardware internal to the FM sound 
generator 1C 
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LOW 


KC* 


HIGH 



KEYBOARD SCALING 


The higher the KC", the faster the rates. Depth determines the 
amount of keyboard rate scaling. 

The other type of keyboard scaling is that for leveL Unlike 
keyboard rate scaling, this is accomplished by MBIOS. 

KS selects two types of keyboard scaling curves. 

When a scaling value corresponding to KC # is taken out of the 
curve, it is multiplied by the Depth to yield the key-scale 
dependent offset (adjusted by Depth in effect). Depth serves as a 
sensitivity adjustment for level scaling. (Up to -24 dB). 


[Multiples] 


Multiple (Harmonic number, indicated as an F in the FM voicing 
program) creates integer multiples (1/2,1,2,3,-., 15) of the keyboard 
pitch for each operator. 

The ratio between the Multiple of the carrier frequency and the 
Multiple of the modulator frequency plays an important role in 
determining harmonic structure of the sound. 


IDT2] 
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DT2 (Detune*2/Inharmonic) is used to create inharmonic 
multiples of the keyboard pitch. 

It is useful to create an inharmonic pitch for sound such as a gong, 
bell, etc. 


IDT 11 


DT1 (Detune* 1 /Fine) is used to shift the pitch oT the operator 
slightly out of tune. Detuning is useful to obtain a chorus effect, or 
richer sounds. 


[Feedback] 


The Feedback Level adjusts the amount of feedback to the first 
operator (from itself) of each channel over a maximum range erf up 
to A *PI radians. 

This is useful to enrich the upper harmonic structure of the sound 
caused by the 1st operator. 


[Algorithm! 

Algorithm determines how the operators are connected together. 
There are 8 ways to connect the A operators in each channel. 

[Stereo L/Rl 


Stereo L/R is an output-enable function that allows the output to 
be routed to either the left, right, or both channels, as desired. 
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2-5 Recording and Playback 


Related SV-calls k memory reference: 

S-02 define EVB 

S-04 initialize EVB 

S-23 read EVB 

S-24 write EVB 

R-08 start recording 

R-09 set recording clock 

R-OA stop recording 

R-OB start playback 

R-OC set playback clock 

R-OD stop playback 

f.evb MlDB(R)/recording, playback status 

mievb M1DB(W)/EVB file name 

MBIOS supports the recording of events retrieved from a queue 
buffer, or playback of the recorded data. 

However, since there is only a single buffer available, it is not 
possible to do both functions at the same time. 

Prior to calling recording or playback function,, the user must 
provide a buffer where bulk of event data is stored or retrieved. 
The name of this buffer is EVB (Event Buffer). There is a service 
call available to tell MBIOS where the EVB is going to be. 

Both recording and playback will be automatically finished when 
the end of the EVB is reached. Recording will also be terminated 
when an ALL-note-off from a corresponding Queue is processed. 

MBIOS also provides file transfer of the EVB to save or load with 
CMT, data cartridge, and disk. 
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2-7 CSM Vocal Synthesis 


Related SV-calls: 

S-0 define IDB Uor IDB 8 CSM) 

S-09 assign channel 

S-28 . CSM voicing 

The vocal synthesis supported by MBIOS is based upon the 
technique called CSM (Composite Sinusoidal Method). 

It simulates the spectrum characteristics of the human voice by the 
generation of a few sine waves of different frequencies. 

In the case of MBIOS, 4 operators (4 sine waves) approximate 
the spectrum envelope of the voice. 



Operator “1 of channels 8 !) through 3 are used to implement the 
above sine waves. 

CSM vocal synthesis data is divided into overall data and frame 
dependent data "Window" is a time frame (approximately 20 
ms) used to analyze CSM parameters , and it will be used as an 
interval to reconstruct the voice. 

The overall data includes the envelope, E(t). 

The frame dependent data includes the frequency, wi, amplitude, 
Ai, and pitch information of the vocal sound. Pitch can be 
obtained by the interval of resetting the sine wave generation, 
causing the pitch-dependent harmonic components to spread 
around the formant frequency wi. 

When the CSM driver is active, due to heavy IRQ traffic, MBIOS 
suspends all other processes and concentrates on only CSM 
synthesis. 

The CSM driver also requires preset data to be loaded into the FM 
sound generator 1C Hence IDB*CSM is used. The format of 
IDB*CSM is identical to that of any other IDB. However, except 
for voice * 46 in the voice library ( and hence can not be modified 
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) there is no user processable data in the IDB*CSM. 



The above illustrates the principle of CSM voice synthesis. That is, 
one spectrum component of possible four formants is generated. 
Within the frame interval, exponentially decaying sin-wave ( with 
its formant frequency and intensity being KC and OL respectively) 
is repeatedly calculated with the given pitch. 

The voice pitch is actually the analyzed data from the original 
sound, and realized in such a way that envelope repeats by itself 
with interval given by 1 /pitch. This repetition is internally done 
within the hardware of FM chip, using clock-A (no interrupt 
occurs). 

Frame interval is the timing that input data for the genaration of 
formant should be updated. This is actually the frame length that 
was used in the formant analysis (frame length of auto correlation 
window, say 20 ms). 

This interval is determined by appropriatelyloaded clock-B 
interval timer. When the interval depletes, IRQ is generated to 
MBIOS, so that MBIOS knows the timing of data update with neit 
frame data. Note that, actual loading of the frame data into the 
calculation circuit of LSi is synchronized with the end of current 
frame calculation. LSI has latches to hold these data until clock-B 
timer is depleted. 

In order to call CSM driver, whole CSM data (as depicted in the 
following page) should be prepared with its lop address pointed by 
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the argument to the CSM-calL 

The whole CSM data is comprised of successive voice pattern 
information. The voice pattern information is a meaningful unit of 
voice. 

In each pattern, there are succession of formant frames. Each 
frame was derived per one CSM analysis window. 

Finally frame data is comprised of four fomanl frequency (KC) and 
four formant intensity data. 

Naturaly, while MBIOS is running CSM sysnthesis, four sin-wave 
generations are taking place simultaneously. 



CSM DATA 


PATTERN FORMAT 


FRAME FORMAT 



OL « OOH - 7FH (FORMANT INTENSITY) 
-0.75 DB STEP 


KC - [OXXXYYYY] (FORMANT FREQUENCY IN KC») 


XXX=OCTAYE NUMBER 
YYYY=NOTE NUMBER 
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Chapter III MBIOS Interface 


i 


A ’7 
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3-1 User Interface 


MBIOS control is handled via the SV-call (supervisor call) and IRQC 
(IRQ-call). 

On the other hand, MBIOS can call the user via AST (Asynchronous 
System Trap ) and UISV (User Interrupt Service Vector). 

The genral format to transfer data between the MBIOS and the 
user program is by means of registers and tables (or buffers). 

The latter include the MIDB (Master Instrument Definition Block), 
IDB (Instrument Definition Block), EVB ( Event buffer), and UVL 
(User Voice Library). 

These are the buffers that are accessible in the program by both 
MBIOS, and the user program. 

There also exist some temporary buffers used in SV-call processing 
only during the specific SV-call routine. 


User program to MBIOS interface: 

SV calls (Service calls) 

IRQC (Interrupt entry) 

MBIOS to user program interface: 

AST (Asynchronous System Trap) 
UISV (User Interrupt Service Vector) 




FFFFh 


MBIOS 

TRANSFERS 



MBIOS INTERFACING 
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3-2 Memory management 


{Slot switching] 


The management of the slot switching is left up to the user. 

For example, assume that 0000h-3FFFh of the BASIC interpreter is 
mapped in front, and when an interrupt needing MBIOS service 
just arrives to the system. It is then the user's responsibility to 
switch the slot so as to map the MBIOS slot in front, then get 1RQC 
service by MBIOS, and finally switch back to the original slot in 
order to eiit from that interrupt. 

However, as an exception, when the service of file transfer with 
CMT, data cartridge or disk, is requested, MBIOS switches the slot ( 
assuming the primary slot 8 0 for BASIC only) by itself 
appropriately to appropriate the file services provided in the 
repertoire of BASIC interpreter. Thus, during these services, there 
is no need for the user to worry about slot switching and interrupt 
handling. 

[Memory map] 


The memory allocation under MBIOS control is as shown in the 
following. 

In the case of SFG-01, or under operating mode 1.0, the area from 
EDOOh to F37Fh is a fixed work space for MBIOS. 

The area from ECOOh to ECFFh is for the MIDB. 

Other areas such as IDB, EVB, UVL, and the stack area can be 
allocated anywhere between 8000h and ECOOh. 

The above fixed mapping:, that is, the operating mode 1.0 conforms 
to SFG-01 MBIOS memory mapping. 

However in the case of operating mode 1.1 and 2.0, the base 
address for MIDB and MBIOS work (780h bytes in total) can be 
allocated anywhere in RAM (between BOTTOM and HI MEM). 
Selection of the operating mode and the allocation of base address 
are done by 1-call (1.0, 1.1, or 2.0). 

In doing indexed addressing of the variables in MIDB and MBIOS 
work MBIOS internally uses 128 bvtes (between F975h and 
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F9F5h) of PLAY queue buffer. Remaining 256 bytes of the queue 
buffer can be freely used by application program. 

While MBIOS is active, to avoide possible invokation of PLAY 
routine or BASIC, PLAY hook is replaced with NOP routine at the 
beginning of I-calL 
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3-3 Direct Access to MIDB and IDB 


[M1DB] 


The MIDB (Master Instrument Definition Block) occupies a 256 
byte area starting at base address specified by I call (in the case of 
SFG-01, it is filed to ECOOh). 

The map of MIDB is shown in the following pages. 

Part of the MIDB is used as a work area by MBIOS. 

MBIOS maintains various system status bytes and the user can 
refer to them to know what is going on (reporting bytes). 

Some bytes are related to the parameters of synthesizer 
performance, such as transposition, clock interval variables, and so 
on. 

It is possible to directly change these to affect the synthesizer 
perfomance. 

There are also vectors for UISV (User Interrupt Service Vector), 
and AST's. 

When using interrupt and trap functions of MBIOS, it is necessary 
that these vectors be loaded appropiately by the user. 

Finally, some SV-calls require related parameters to be set in MIDB 
before the call is made. 

These calls are related to those for LFO handling, noise, and file 
name specification for the CMT handler. 
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lilDB MAP 


Name 

Address 

Offset 

R/W 

Contents 

Explanations 

m.clka 

OOh 

W 

1**00 0000] 
[«*** ****](♦ ]) 

(clock-A interval) 
clock-A low 
clock-A high 

0000h*18.2 ms (max) 
8000h-9.l ms 

FF00h*0.07l ms (min) 

m.clkb 

02h 

W 

l-1 

****](+ ] ) 

[clock-B interval) 
clock-B low 
clock-B high 

0000h-72.8 ms (max) 
8000h-36,4 ms 

FFOOh=0.285 ms (min) 

m.trns 

04h 

W 

[**»* »»*W] 

f WV V V V V V 1 

1 7\/T/\a “aa A I 

[Master transposition) 
Fractional pitch 

KC (2‘s complement) 

m.lfo 

lOh 

W 

r w w \/w w wi 

1 A a A a A A A A J 

[LF0 frequency] 

m.amd 

11h 

W 

[0*** #***] 

(AMD) 

m.pmd 

12h 

W 

[0**« »***] 

(PMD) 

m.ctrl 

13h 

W 

[0000 00**] 

IWave form of LF0] 

m.nois 

14h 

W 

[xOO-] 

[-00y yyyy](+0) 

(Noise control of channel 7] 
<1> noise enable 
noise frequency 

f.evb 

lBh 

R 

O 

♦ 

T >s 

X 1 

o o 
o o 
o o 
o o 
o o 
o o 

Recording/Playback status 
<1> recording,<0> playback 
<1> busy 

m.chrd 

23h 

R 


(reserved) 

m.sram 28h 

R 

[2 byte L/H] 

(s-ram sizel 

mlft 

2Ah 

W 

[0000 00-xl 
10000 00v-l( + 0) 

(MIDI-out switchl 

<1> F8h to MIDI bv Timer-A 

<1> F8h to MIDI bvTimer-B 




m.i38h 30h 

W 

[2 byte vector] 

{0038h UISV] 

m.icka 32h 

W 

[2 byte vector] 

(IRQ-A U1SV) 

m.ickb 34h 

W 

[2 byte vector] 

{IRQ-B UISV) 

m.iund 38h 

W 

[2 byte vector] 

{unidentified-IRQ UISV] 

mtrmd 3Ah 

W 

[2 bvte vectorl 

(MIDI fifo/receive 




vectorl 

m.trmk 3Ch 

W 

[2 byte vector] 

(MK trigger trap] 

m.trer 3Eh 

W 

[2 byte vector] 

(error trap vector] 

m.fevb 44h 

W 

[6 byte string] 

(file name for EVB data) 

t.rhyO 88h 

w 

196 byte ] 

(reserved) 


m.thru E8h W 
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IIDB1 


IDB is a 128 byte control block to represent currently opend 
instrument. 

The IDB also can be directly accessed to dynamically modify the 
instrument parameters. 

While the MIDB parameters affect entire system performance, the 
parameters in the IDB affect the performance of individual 
instruments. 

Since the IDB is defined by the user program, its address should be 
known to the user. In the following pages, the IDB map is 
depicted. 
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IDB MAP 


Name Address R/W Contents Explanation 

offset 


i.krng 

OOh 

w 

[0*** ****] 

[0*** ****](+ ] ) 

(Key code range] 

Highest key code 

Lowest key code 

i.pchb 

02h 

w 

[0000 ****] 

[Pitch-bend depth] 

00h=0 cent 

01h-100 cents 

08h-1200 cents 

i.trns 

03h 

w 

[*XX* *XK*] 
[*WX* 1 ) 

[Tmsposition by instrument] 
Fractional pitch 

KC, (2's complement) 

i.port 

05h 

w 

[**** ***»] 

[Portamento speed) 

OOh=no portamento 

Olh-fast speed 

FFh»slowest 

i.sust 

06h 

w 

[0000 ****] 

[RR(Release rate) when 
sustain/on is requested] 
applies to all 4 operators 

v.name 

i 10h 

R/W 

[48 byte voice] 

Ivoice data] 
loaded by MB105 upon 
issuing SV-call 
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3-4 IRQ Processing via UISV 


I IRQ modes) 


MB10S operates on IRQ mode of either I or 2 of the Z80 CPU, 
depending on the choice of operating mode (1.0,1,1. or 2.0). 

IRQ mode 1 is set during the processing by the I-calll.0/1.1. 

IRQ mode 2 is set during the processing by the I-call 2.0. 

IRQ mode I is compatible to MSX standard interrupt, 38h as its 
interrupt entry. 

IRQ mode 2 is vectorized interrupt. This is espetially useful when 
fast processing of MIDI reception is to be implemented. 


In addition to the IRQ mode of the system, whether the state 
should be Eled or Di ed differs the types oT SV-calls to be used. 
In the operating mode2.0, the following services should be 
requested under IRQ-disabled condition. 

I-call, End-call, M_MONITOR -call 

RDSLT, WRSLT, CALSLT, ENASLT, CALLF, RDPP.O 

The following service requests can be made under IRQ-Enabled 
condition. 

R. S. P, K, M, F-call, BDOS-call 
UISV (micka, mickb, miund, m.trmd) 

AST (m.trmk, m.trer) 


{Source of interrupts! 


For MBIOS, there are 3 sources of interrupts that are generated by 
the hardware of SFG-05; i.e.. Clock-A and clock-B and MIDI chip. 
Including VDP as another source oT interrupt, 4 sources of 
interrupts should be considered. 

When I-call 1.0/l.l « first issued to initialize MBIOS, clock-A and 
clock-B are automatically interrupt enabled. 

For applications that require disabling the clocks afterward refer 
to section 4-5. 
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If MIDI-FIFO has been defined and if l-call2.0 is requested, MIDI 
chip is also interrupt enabled. 


[Interrupt control flow in the operating mode 1.0/1.11 


In the following figure-A, operating mode 1.0, and 1.1 are 
illustrated. 

This mode is compatible to Interrupt handling of SFG-01. 

Note that when mode 1 interrupt hits to 38h IRQ entry address, 
the interrupt is disabled until necessary processing is completed. 

If the interrupt directly hits 38h, there is an option provided by 
the MBIOS by which the transfer is made solely to user's 
processing routine. 

This can be done with MBIOS by refering to UISV i38h. 

If that UISV is not defined, the control flow goes to the next stage 
where the source of interrupts are polled. 

The polling is made according to the priority depicted in the figure; 
that is, clock-A, clock-B, and other source (normally VDP). 
(However in operating mode 2.0, the priority order between clocks 
A and B can be changed by S-OE call). 

If the souce of the interrupt is identified, and if the corresponding 
UISV is defined in MIDB, then the jump is made to the designated 
user's routine. 

When clock-A or clock-B is detected, the source of interrupt is 
reset by MBIOS before the jump is made. However, for the last 
branch (other cause, VDP, etc.) no attempt is made to reset the 
interrupt request registers. Thus it is a user s responsibility to 
reset the interrupt cause in that routine. 

User also has to enable interrupt (El) before he issues RET in his 
handling routine. 

Also in operating mode 1.0 or 1.1, IRQC-caii (009Fh entry) is 
provided in order for the user to jump into the interrupt 
processing from the different slot. This is usefull if the user 
detects the interrupt in the different slot, say in BASIC interpreter, 
and tries to route the control to the MBIOS by way of BASIC's 
interrupt hook. 
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Save Registers 


Restore Registers 


Fig. 3.2-A IRQ Control Flow in Operating mode 1.0 &. 1.1 
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(Interrupt control flow in the operating mode 2.01 


In the following figure-B, the procedure for the operating mode 
2.0 is illustrated. Here, mode2 interrupt is of cource assumed. 
Mode 2 vector is defined in the work space of MBIOS, and there it 
is invisible from the user. 

Defining the vector and setting mode2 are done during the I-call 
with operating mode 2.0. 

When MIDI interrupts caused by Tx RDY or Rx RDY hits the system, 
the processing is done by the MBIOS totally independent upon the 
rest of interrupt processing. 

It is assumed that 256 byte FIFO for MIDI reception has already 
been defined. That is, by way of a separate vector, when RiRDY is 
the cause of the interrupt, the received MIDI data is buffered into 
FIFO buffer. 

When MIDI data is stored into the FIFO, MBIOS raises the flag to 
tell that FIFO is significant, which will be further processed later 
on. 

Also MIDI data is written out when TiRDY is the cause of interrupt 
The interrupt is disabled during the above processing. 

However, the processing is completed very quickly so that no 
possibility of UART over-run is anticipated. 

in the meantime, if the cause of the interrupt is something other 
than MIDI (this is judged by interrupt arbitration logic in the MIDI 
chip), the separate vector routes the control to the process depicted 
in the left hand half of the figure-B. 

Here, the option to the private processing is provided via UISV, 
mJ38h. However, for MIDI processing, it is strongly advised not 
to use this option due to the compiexicity of DI/EI management. 

The polling method of the interrupt cause is somewhat diferrent 
from that of the operating mode 1.0/1.1. 

Here, after mi38h check, the possible causes of interrupts are 
polled at once and corresponding flags are made. IRQ causing 
registers are also cleared. And El is issued at this point. 

This enables the MIDI interrupt still hits the system. 

Naturally, the other source of the interrupt might come to the 
system as well. 

Therefore during this process of job schecduling, the use-count 
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management is involved. 

Now, in the process, the first flag to be scanned is MIDI flag. U it is 
on, and if UISV m.trmd is defined, the jump is made to designated 
user routine where received MIDI data should be fetched out of 
FIFO. Since El has already been issued, there is no need for user's 
individual routine to issue El before RET. 

After MIDI flag, clock-A, clock-B, and VDP are scanned in that 
priority order. Branching method is the same as done in operating 
mode 1.0/1.1. 

Also notice that IRQC-cali is not available in the operating mode2.0. 
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FIG. 3.2-B IRQ control Flow in Operating mode 2.0 
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3-5 AST (Asynchronous System Trap) 


AST is a means to transfer the program control from MBIOS to the 
user program asynchronously. 

This is used when MBIOS wants to let the user know the timing of 
an error, or the occurrence of MK triggers. The timing of these 
events is, by nature, unknown, thus asynchronous. 

When an AST is required, the user is required to define the trap 
vectors in MIDB prior to the start of real time handling. 

If vectors are not defined, the trapping will not occur. 

There are two trap vectors in MIDB; <M.TRMK> for MK and 
<M.TRER> for error. 

<M.TRMK> is a vector to transfer the key-on/off information ( 
which is asynchronous to the user routine by nature) from MBIOS. 
Music keyboard should be scanned . Hence, <M.TRMK> should be 
used together with service call K-01 (scan MK). 

Since AST may be generated right in the middle of an SV-call, in 
operating mode 1.0/1.1, issuing another SV-call or enabling the 
interrupt is not allowed in the AST handler. 

However, in operating mode 2.0, the system assumes that 
interrupt is left enabled even when trap is occurred. However, in 
AST, no SV-call but F-call should be requested. BDOS-call should 
not be called either. 

When returning from the AST routine, issue a <RET>. 

Restoring the registers is not necessary. 

In the following figure, typical AST usage is depicted. 

Register contents when AST is invoked; 


I A] trap code 

<C> 

IBC1 

IDE] arg 

IHL) 

IIX/IY] 

(alternate R.) - 
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USER'S 

TRAP 

HANDIER 


:USER'S .PROGRAM RUNNING ; : : 
;HERE INDEPENDENTLY UPON 
TRAP ROUTINE: : : : : : : : 


SY-CALL 


SCAN MK 
(K-OI -CALL) 


^ MK_JCHRD_TRG: 

RET 

^ ERROR-HNDLR: 

RET 


JMP «»M.TRMK 
JMP «*M.TRER 


JUMP BY MBIOS 
WHEN TRAP CONDITIONS 
OCCUR 


M.CLKA: 


M.TRMK: 

M.TRER: 


TRAPYECTOR IN 
MIDB 


MK—CHRD-TRG 

ERROR-HANDLR 




CAUSEDINTERNALLY BY 
SY-ROUTINES OF MBIOS 


FIG. 3.5 AST U5AGE 
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3-4 Supervisor Call 


There are 9 different SV-call's available, as follows: 


1-call 

(Initialize) 

E-call 

(end MIDB) 

R-call 

(real lime) 

K-call 

(Music keyboard) 

P-call 

(Play) 

S-call 

(Set up) 

M-call 

(Receive MIDI) 

F-call 

(FIFO management for MIDI application) 

BDOS-call 

(Disk access) 


Once issued, an SV-call will not return to its call-source until its 
processing has been completed. 

However it does not mean that SV-call's have to be issued one after 
other by waiting for the previous one to finish. 

Most of the above calls can be issued simultaneously under certain 
conditions. 

This feature enables the parallel processing of music events. 

That is, while P and K calls are being processed, R and M calls 
also can be issued in the UlSV interrupt routine. 

To do this, the system was designed that P-calls and K-cails will 
function in either interrupt-enabled or disabled conditions. 

The other SV-calls will run properly, only if interrupts are 
disabled. 
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11-call (Initialize)] 


calling sequence: 

DI 

CALL 0090h (operating mode 1.0) 

00A8h (operating mode 1.1) 

OOABh (operating mode 2.0) 

(call is returned with interrupt status being disabled). 

register conditions: 

in out 

[A] - * 

<C> 

IBC] 

IDE] MIDB base address * 

(for operating model.1/2.0) 

IHL] 

IIX/IY] - 

(alternate R.] - 0 

where 

contents do not matter 

arg arguments associated with function code 
* contents will be destroyed 

o contents will be maintained 


1 1-call is an initialization requirement for MB10S. 

2 the interupts should be disabled before 1-call. 

3 Three dirrerent entries for three different operating modes. 
(This conforms to the compatibility to the program written on 
SFG-01). 

4 I-call 1.0 (operating mode 1.0): 

-Compatible to MBIOS of SFG-01. 
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-Fixed address M1DB and MB10S work. 

-sets IRQ mode 1. 

5 I-call 1.1 (operating mode 1.1): 

-Base address of MIDB is set anywhere in RAM. 

-sets IRQ model. 

6 I-call 2.0 (operating mode 2.0): 

-Base address of MIDB is set anywhere in RAM. 

-sets IRQ mode 2. 

7 In processing of I-call, MBIOS grabs and intializes BASIC's 
PLAY buffer (between F975h and F9F5h) for necessary indirect 
addressing of MIDB. 

MIDB also alters the PLAY hook to NOP so as to prevent PLAY 
queue area from being accidentally accesed by PLAY entry. 

It will be freed when END-call is issued. 
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lE-call (End MBIOS)] 


Calling sequence: 

D1 

CALL OOBth 

(call is returned with interrrupt status being disabled) 
Registers: 

in 

1A1 

<D 

IBC1 

[DEI 

IHL1 

[1X/IY1 - 


1 Closes MBIOS and disables all the interrupt sources of SFG-05. 

2 Frees queue buffer area of PLAY by BASIC routine. 

(The queue buffer between F975h and F9F5h has been used as 
fixed address pointer area for indirect addressing oT M1DB and 
MBIOS work). 

3 The interrupt mode is reset to mode-1. 
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iR-call (Real time)l 


Calling sequence: 

Opearating mode 1.0/1.1: 

D1 

CALL 0093h (or 0008h) 

(call is returned with interrupt staus being disabled) 

Operating mode 2.0: 

El 

CALL 0093h (or 0008h) 

(call is returned with interrupt status being enabled) 

Registers: 



in 

out 

IA) 

func” 

status 

<C> 

- 

error 

IBC] 

arg 

x 

IDE] 

arg 

X 

IHL] 

arg 

X 

{IX/IY] 

- 

0 

(alternate R.] 

- 

0 


1 R-call is a real time processing call. 

2 The functions of R-calls involve generation of events and 
clocks. 

3 R-call can be issued in UISV's. 

4 R-call can be issued in AST-01 but not in AST-02. 

5 Run time error, if detected, will be indicated by the <D flag 
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IK-Call (Music keyboard)] 


Calling sequence: 

Operating mode 1.0/1.1: 

DI (or El) 

CALL 0096h 

(call is returned with interrupt status being same as it 
entered) 

Operating mode 2.0: 

El 

CALL 0096h 

(call is returned with interrupt status being enabled) 


Registers: 



in 

* 

out 

[A] 

func* 


0 

<C> 

- 


busy 

IBC] 

arg 


* 

[DEI 

arg 


* 

IHLl 

arg 


» 

IIX/IYl 

- 


0 

(alternate R.1 

- 


0 


1 K-call is used for the initialization and scanning of ML 

2 The busy condition (<C>« 1) occurs when a K-call is issued before 
the previous K-call has been completed. 

3 K-call can be issued in UISV traps. 

■i K-call can not be issued in AST's. 


71 



October 30, 1985 


iP-Call (Play)] 


Calling sequence: 

Operating mode 1.0/1.1: 

Dl/EI 

CALL 0099h 

(call is returned with interrupt status being same as it 
entered) 

Operating mode 2.0: 

El 

CALL 0099h 

(call is returned with interrupt staus being enabled) 

Registers: 

in out 


[A] - 0 

<C> - error 

IBC] 

IDE] queue map * 

|HL] 

IIX/IY] - 0 

[alternate R.] - o 


1 P-call retrieves events from the queue and plays them using 
the corresponding IDB. 

2 The busy condition occurs when P-call is issued before the 
previous P-call has been completed. The second P-call is 
ignored. This will be indicated by <C>. 

3 P-call can be issued in UISV traps. 

4 P-call can not be issued in AST's. 
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iS-Call (Set up)] 


CaiJing sequence: 

Operating mode 1.0/1.1: 

DI 

CALL 009Ch (or 001Oh) 

(call is returned with interrupt status being diabled) 

Operating mode 2.0: 

El 

CALL 009Ch(or 001Oh) 

(call is returned with interrupt status being enabled) 

Registers: 



in 


out 

[A1 

func* 

- 

error® 

<o 

- 


error 

IBC1 

arg 


a 

IDE! 

arg 


a 

IHL] 

arg 


a 

I1X/IY1 

- 


0 

[alternate R.] 

- 


0 


1 S-call is a request that does not require real time processing. 

2 <C> = 1 indicates that error has been detected. 

3 IF <0=1 and; 

A=0Gh , then busy condition (P-call, K-call or another 
S-call is busy). 

A is non-zero, then other error was detected. 

For detail, see individual S-call syntax. 

4 S-call can be issued in UISV traps. 

5 S-call can not be issued in AST's. 
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[M-call (Receive MIDI)] 


Calling sequence: 

Operating mode 1.0/1.1: 

DI 

CALL 00A5h 

(call is returned with interrupt status being disabled) 

Opearating mode 2.0: 

El 

CALL 00A5h 

(call is returned with interrupt status being enabled) 


Registers: 

in out 

IA] 

<C> 

[BC] 

IDE] 

IHL] 

IIX/IY] 

[alternate R.] - 


o 

data/status 

o 

o 

o 


1 M-call scans the MIDI input port or MIDI-FIFO. 

2 U data is present at the port, it fetches the data in the D 
register. 

3 E register contains, when returned, MIDI interface status. 

4 M-call can be issued in UISY traps and AST's. 
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IF-Cail (FIFO management)] 


Calling sequence: 

Available only in operating mode 2.0: 

El 

CALL OOBlh 

(call is returned with interrupt status being enabled) 

Registers: 

in out 

IA] func* 

<C> 

IBC] parameter 1 

|DE| parameter * 

[HL] - 

I1X/IY] - o 


1 F-00 clears the reception FIFO buffers for MIDI communication. 

2 F-01 clears the transmission FIFO buffers for MIDI 
communication. 

3 FIFO buffers can be defined by S-05 call. 

4 F-02 is to reset the error flag of MIDI communication channel, 
occured during the MIDI reception. 

5 F-03 is a function to send MIDI-real-time-data (F8h-FFh). 

This is equivalent to R-21 call. 

6 F-call can be issued in U1SV traps and AST's. 
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(BDOS-call (Disk access routines)] 


Calling sequence: 

operating mode 1.1 
DI 

CALL 00B4h 

(call is returned with interrupt status being disabled) 

Operating mode 2.0 
El 

CALL 00B4h 

(call is returned with interrupt status being enabled) 

Registers 



in 

out 

IAI 

see BASIC 

status 

<C> 

- 

<0> normal <1> illegal 

[BC] 

see BASIC 

see BASIC/substatus 

IDE] 

see BASIC 

see BASIC 

IHLI 

see BASIC 

see BASIC 


1. MBIOS disables IRQ state in lh.kei] routine. 

2. Illegal call conditions 

-MBIOS is already performing BDOS-call. 

-Disk does not eiist. 

-MBIOS is already performing SV-call or UISV. 

3. Status 

-FEh; disk error (with sub status) 

-other ; see BDOS status manual 

A. Substatus 

<01 h> write protected 

<02/03h> drive not ready (R/W) 
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<04/05h> CRC error (R/W) 

<06/07h> seek error (R/W) 

<08/09h> record not round (R/W) 

5 BDOS-call can not be issued in U1SV or AST. 
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CHAPTER IV MBIOS Syntax 
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4-1 


1 - call 


Unitialize MBIOS: Opearating mode 1.0) 

Entry address: 

0090h 

Registers: 

In Out 

IAJ 

_ a 

<C> 

- 

IBC] 

_ a 

IDE) 

m m 

IHL] 

_ a 


1 This is a compatible mode to I -call of SFG-01. 

Necessary MB10S work is allocated to the same memory address as 
that filed to SFG-01. 


2 DI prior to I-call. 

3 Although in this mode, the base address of MIDB is filed to ECOOh, 
The internal addressing to MIDB still uses indirect addressing using 
128 bytes of BASIC's queue buffer (F975h)for pointers. 

To prevent this buffer from being accidentally used, BASIC's PLAY 
entry is deactivated by I-call processing. 

4 Initialization includes the following operation. 

i Initialize the MIDB. 

ii Gear AST and USIV tables. 

iii Gear IDB, UVL, and EVB buffers. 

iv Set Z80 interrupt mode to mode 1. 

v Enable clock-A, and clock-B. 

vi Initialize PLAY-queue area with pointers 

v Load OOh into MUSICF (FB3Fh), and replace hook 
H.PLAY (FFC5h) with: 
pop hi 
ret 
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Summary of default settings in the MIDB and system status during an 
1-call: 


MIDB: 


Clock-A 

m.clka: 

8000b (enable interrupt) 

Clock-B 

n.clkb: 

8000h (enable interrupt) 

Master transposition 

m.trns: 

OOOOh 

LFO speed 

m.lfo: 

OOh 

LFO waveform 

m.ctrL 

Oh (saw-tooth) 

AMD 

m.amd: 

OOh 

PMD 

m.pmd: 

OOh 

Noise 

m.nois: 

OOh (disabled) 

U1SV table 

m:i38h: 

all OOh 

AST table 

m.lrmk: 

all OOh 

System status: 

Default RHB pointed 


RHB»0 

IDB's 


all cleared 

EVB and UVL 


ail cleared 

Brilliance 


FFh 

Pitchbend 


OOh 
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I - call 


(Initialize MB10S: Opearating mode 1.1) 


Entry address: 

00A8h 


Registers: 

In 

Out 

[A] 

- 

* 

<C> 

- 

- 

IBC] 

- 

m 

IDE) 

MIDB base address 

s 

[HL1 

- 

s 


1 This is an entry to operating mode 1.1. 

In operating mode 1.1, MB10S work (M1DB) can be allocated 
anywhere in ram. 

2 Z80's interrupt mode is set to mode 1. 

2 In order to implement indirect addressing to M1DB, MB10S uses 
128 bytes of BAlSCs queue buffer (F975h) as a pointer bank. 

To prevent this buffer from being accidentally used, BASIC's PLAY 
entry is deactivated by 1-call processing. 

4. Initialization includes the following operation. 


i Define and initialize the M1DB (780h bytes) 

ii Clear AST and USIV tables. 

iii Clear IDB, UVL, and EVB buffers. 

iv Set up pointers into PLAY-queue buffer. 

v Load OOh into MUSICF (FB3rh), and replace hook 
H.PLAY (FFC5h) with: 

pop hi 
ret 

vi Set Z80 interrupt mode to mode I. 

vii Enable clock-A, and dock-B. 
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1 - call 


(Initialize MBIOS: Opearating mode 2.0) 

Entry address: 

OOABh 



Registers: 

In 

Out 


(A] 

- 

S 


<C> 

- 

- 


1BC] 

- 

* 


IDE1 

MIDB base address 

» 


IHL] 

- 

s 



1 This is an entry to operating mode 2.0 

2 In operating mode 2.0, MBIOS work (M1DB) can be allocated 
anywhere in ram. 

3 Z80's interrupt mode is set to be mode 2. 


3 In “"der to implement indirect addressing to MIDB, MBIOS uses 
128 bytes of BASIC’s queue buffer (F975h) as a pointer bank 

To prevent this buffer from being accidentally used, BASIC's PLAY 
entry is deactivated by 1 -call processing. 

4 Initialization includes the following operation. 


i 

ii 

iii 

iv 

v 


vi 

vii 

viii 


Define and initialize the MIDB (780h bytes) 

□ear AST and USIV tables. 

□ear IDB, UVL, and EVB buffers. 

Set up pointers for indirect addressing of MIDB into 
BASIC's PLAY-queue buffer. 

Load OOh into MUSICF (FB3Fh), and replace hook 
H.PLAY (FFC5h) with: 
pop hi 
ret 

Set Z80 interrupt mode to mode 2. 

Set internal mode-2 vector. 

Enable clock-A, clock-B, and UART 
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{4-2] END-call 


{Shut down MBIOS : operating mode 1.1 and 2.0} 


Entry address: 00B7h 


Registers: in 

out 

[A] 

* 

<o 

* 

IBC] 

* 

IDE] 

B 

iHL] 

IIX/IY] 

* 

B 


1 This resets MBIOS to normal MSX operating environment. 
-Frees BASIC's queue buffer 

-resets PLAY hook to normal 
-set Z80's interrupt mode to model 

2 do not issue END-call while END-call has already been issued. 
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4-3 R - call 


K - 00 System All-note-off (damp) 

(Ihis issues All-note-off events into all 7 Queues and damp all the 
engaged channels) 

Entry address: 

0093h 

Registers: 


[A] 

OOh OOh 

<o 

- 

IBC] 

. < 

IDE) 

_ 1 

IHLJ 

_ ■ 


( 84 ) 



R - 01 


All-note-off 


{Issues All-note-off event to designated Queue) 

Entry address: 

0093h 


Registers 



[A] 

Olh 

OOh 

<C> 


<0> 

IBCJ 

QU*/- 

X 

(DEI 

- 

X 

(HLJ 

- 

X 


1 QU« 1B1 

IOOOOOxxx] ixx«=0 - 7 ,QU» 
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R - 02 Set Event into Queue 


(Sets event into designated Queue) 

Entry address: 

0093h 


Registers. 



|A) 

02h 

OOfc 

<o 

- 

error 

!BC] 

QU*/- 

* 

IDE] 

Event 

t 

[HL] 

- 

* 


1 QU* 1B1 

IOOOOOxii] xn=0 - 7 ;QU“ 


2 An error <C> will be set when the QUEUE is already full, and the 

corresponding event will not be registered into the Queue. 

3 The event format: 



15 


8 7 

6 5 4 3 

2 1 

0 

Nu i E ON 

DU 

KC- 

, , 1 

■ ytLOCITY 


□ 


15 


8 7 

6 5 4 3 

2 1 

0 

NOTE OFF 

DL 

kc* 

0 

o 

o 

o 

o 

"oTo 

0 


ALL NOTE OFF (NO DATA) 
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R - 08 Start Recording 


(Start recording from the designated Queue to the EVB) 


Entry address: 

0093h 


Registers: 



IA] 

08h 

OOh 


- 

<0> 

1BC] 

qu 5 /- 

* 

IDE] 

- 

m 

IHL1 

- 

■ 


! QU* IS] 

[lOOOOxxx] xix«0-7,QU* 

2 This will be ignored when the EVB is undefined. 
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R - 09 Set Recording Clock 

(This provides the timing clock for recording). 
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Entry address: 

0093h 


Registers: 

IA] 

09h 

00b 

<o 

- 

<0> 

IBC1 

- 

m 

IDE) 

- 

■ 

IHL] 

_ 

> 


1 This will be ignored in any mode but recording. 

2 To formulate the clock pulse train, this is normally issued 
successively in each interrupt handler routine. 
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R - OA Stop Recording 


(This stops the recording from Queue) 


Entry address: 

0093h 


Registers: 

IA] 

OAh 

OOh 

<o 

- 

<0> 

IBC] 

- 

« 

[DEI 

- 

m 

[HL1 

- 

« 


1 This registers an Ali-note-off event for a Queue that was being 

recorded. 

2 This will be ignored in any other mode than recording. 
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R - OB Start Playback 

(This carries out playback (rom the EVB for the designated Queue.) 


Entry address: 

0093h 


Registers: 



IA] 

OBh 

OOh 

<C> 

- 

<0> 

IBC1 

QU*/- 

s 

IDE) 

- 

* 

IHL) 

. 

m 


1 QU* [B] 

IIOOOOjii] iii=0 - 7 ;QU# 

2 This will be ignored when the EVB is undefined, or while playback/ 
recording is already busy. 
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R - OC Set Playback Clock 


(This provides the timing clock for playback). 

Entry address: 

0093h 

Registers: 

IA) 

OCh OOh 

<C> 

<o> 

IBC1 

* 

[DEI 

m 

IHL] 

_ c 


1 This will be ignored during every mode except for playback. 

2 To obtain a clock pulse train, this call is normally issued 
successively in each clock interrupt routine. 
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R - 0D Stop Playback 
(This stops the playback). 

Entry address: 0093h 

Registers: 

(AJ 
<C> 

IBC] 

IDE) 

IHL] 

1 played back” AI1 ' note ' off event for the Queue that was being 

2 This will be ignored in any other mode than playback. 


ODh 00b 

< 0 > 
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R-18 Load LFO 


{Load LFO parameters into the FM sound generator 1C). 

Entry address: 

0093h 

Registers: 

IA1 

18h OOh 

<C> 

<0> 

IBCJ 

_ a 

[DE] 

■ 

IHL1 

» 


1 Preset the following LFO parameters into the M1DB prior to 
issuing this command. 

MIDB entries: 


m.lfo 

Speed 

m.amd 

amd 

m.pmd 

pmd 

m.ctrl 

wave form 

m.nois 

noise 
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R *19 Load KC 


(Loads the KC into the FM sound 

generator IC). 

Entry address: 

0093h 



in 

out 

IA] 

19h 

OOh 

<o 

- 

<0> 

IBCj 

- 

ft 

IDE] 

- 

* 

IHLJ 

- 

* 


1 

2 


It is used to load KC information to currenUy engaged channel. 

For portamento application: 

Issue this command in synchronization with CLOCK-A 

Kst ffcMasfcsnjs ™ «■■ 

■Mo assigned cfi a „„eTor ,he c “p MormsMn and be loaded 

uSS^IKSSbS 1 be “ pi “ M » ivM 


3 For transposition: 

With lraas P° s ^ n 8 information, and 

4 for pitchbend: 


»r»SL°:i D “dib p &^ *»«■ issue this 
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R-20 Send MIDI message 


(Outputs a given MIDI 

message MIDI-FIFO for transmission). 

Entry address: 

0093h 


Registers: 


in 

out 

IA) 

2 Oh 

OOh 

<D 

- 

<0> 

IBC1 

message size 

« 

IDE] 

message address 

* 

IHLJ 

- 

S 


1 This transmits a block of data specified by size and its buffer address 
into MIDI-FIFO. 


1 This is generally used to transmit one complete MIDI message packet 
at once into MIDI- FIFtT 

3 Care must be taken when non-MIDI packet is to be sent. 

For there might be a conflict with other requesting routine for the 
same FIFO. 

This call makes no attempt to merge more than one messages, 
that are requesting the same FIFO, into one message stream. 

4 If FIFO is full, it waits until the FIFO becomes ready. 

5 If FIFO is not defined, it transmits a block of data from the MIDI-port 
directly. 

6 If the port is busy, it waits until the port becomes ready. 
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*-21 Send a byte to MIDI 


(Outputs a given single byte of MIDIdata into MIDI-FIFO 
for transmission). 

Entry address: 

0093h 


Registers: 

in 

out 

IA) 

21h 

OOh 

<C> 

- 

<0> 

IBC1 

-/data 

S 

IDE) 

- 

* 

IHLJ 

- 

s 

1 This sends a byte of data to FIFO for transmission. 

Z This i? usally used to trnsmit onlv real time data between FRh and 


3 Care must be taJcen when a byte data between OOh and F7 is to be 
sent. 

For there might be other routine which is using the same FIFO for its 
own data transmission. 

This routine makes no attempt to merge more than one MIDI 
messages into a consistent MIDI message stream when multiple 
number of FIFO requesting sources collide. 

4 If FIFO is full, it waits until the FIFO becomes ready. 

5 When no FIFO is defined, access is made to the MIDI port directly 
If port is busy, it awaits until the port becomes ready. 
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14-41 


K-Call 


K-00 Inil MK 

(Initializes MK, sets velocity for MK, enpHried aueue) 

and establishes the link up between the MK. and the specified que j. 

Entry address: 

0096h 


Registers: 

in 

out 

IA1 

OOh 

OOh 

<D 

- 

busy 

IBC1 

link/mode 

* 

IDE] 

velocity/- 

« 

IHL1 

- 

* 


1 link IBl 


IxOOOOyyy] 


x-<0> no link with queue 
x*< 1 > hnk with queue 
yyy=0-7 , QU* 


2 mode 1C] 


100000001 always 0, 


3 Velocity ID] 

Ixxxxiixx] xxxxxxxi=00h (minimum velocity) to 
=FFh (maximum velocity) 
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trOl Scan MK 

{Scans the MK. Event detected will be written into (linked) queue). 

Entry address: 0096h 

Registers: 

in out 

IA1 Olh 00b 

- busy 

IBCJ 
IDE] 

IHL] 


^ ou.put of this command ts to writs the detected event into * 
queue. ” 

2 Normally, to scan the MK, this call needs to be issued successively bv 

each interrupt cycle. 7 ’ ’ 

3 ir AST vectors for MK has been specified in the M1DB it will 
cause AST trapping via AST vectors. 
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K-02 Report MK status 

(Scans the MK, and returns the on/off status of the MK}. 


Entry address: 

0096h 


Registers: 

in 

out 

IA] 

02h 

OOh 

<0> 

- 

busy 

[BC1 

- 

* 

IDE] 

buffer 

address 

a 

IHLJ 




1 The buffer contents will be comprised of 9 bytes as shown below. 
Each bit represents the on/off status of corresponding key position. 

msb lsb 


0: 

0 

C 

B 

A* 

0 

A 

G» 

G 

higher KC° 

7: 

0 

p# 

F 

E 

0 

D» 

D 

C» 


8: 

0 

C 

0 

0 

0 

0 

0 

0 

lower KC # 
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4-4 P - call 


P Play 

Unis retrieves events from the designated queues, and plays them) 

Entry address: 

0099h 


Registers: 

in 

out 

IA] 

- 

OOh 

<C> 

- 

busy 

IBCJ 

- 

a 

IDE] 

Queue map 

a 

[HLJ 

“ 

a 


1 Queue-map IDE] 

[OOOOOzxxhgfedcba] xii ; reserved (fill zero s). 


a QU"0 
b QU*1 

h.QU»7 


PLAY processes all the event requests in the assigned queues by 
the iueu! gets *e mpty accor<to * J y( note on/ofr) one event by one until 
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4-5 S-catl 


S - 00 Define 1DB 


(Either defines or cancels the IDB). 

Entry address: 

009Ch 


Registfers: 

in 

out 

(A! 

OOh 

OOh 

<C> 

- 

busy 

IBC] 

IDB*/- 

B 

IDE] 

IDB address 

B 

IHL) 

- 

B 


1 Cancels the 1DB when the IDB address (contents of DE) - OOOOh. 

2 Cancelling the IDB, while it is still engaged in key-on, should be 
avoided. 

3 The size of IDB is 128 bytes. 
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Initial setting of the IDB parameters: 


KC range OOh to 7eh 

Pitchbend depth OOh 

transposition by instrument OOh 

portamento speed OOh 

RRfdefault sustain value) 03h 

volume COh 

Voice data cleared 


Initial setting of the IDB mode (held in the system): 

sustain-off 

multi-triggered 

fingered portamento (with 0 speed) 
pitchbend enabled (with 0 depth) 

’ The above setting is equivalent to issuing, mode-0, via an S-12 call. 
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S - 02 Define EVB 

{Either defines or cancels the event buffer (EVB)}. 


Entry address: 

009Ch 


Registers: 

in 

out 

(A) 

02h 

ooh 

<C> 

- 

Busy 

IBC) 

size 

a 

IDE) 

address 

a 

IHL] 

- 

a 


1 The EVB is canceled wnen tne address in iBEj is OGOOh. 

2 When defined, the contents of the EVB will not be cleared. 
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S - 03 Define UVL 

(Either defines or cancels the user voice library (UVL)) 


Entry address: 

009Ch 


Registers: 

Lu 

out 

[A) 

03h 

ooh 

<c> 

- 

busy 

I3C] 

- 

1 

IDE] 

address 

« 

IHL] 

- 

S 


1 TfeC UVL *5 in *5 hoqok 

2 When defined, the contents of UVL will not be cleared. 
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S - 04 Initialize EVB 

{This initializes the event buffer (EVB)}. 


Entry address: 

009Ch 


Registers: 

in 

out 

IA] 

04h 

ooh 

<C> 

- 

busy 

IBC] 

- 

1 

IDE! 

- 

a 

1HL1 

- 

a 
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S-05 Define FIFO 

(This defines FIFO buffer for MIDI transmitter/receiver) 

Entry address: 

009Ch 


Registers: 

in 

out 

IA1 

05h 

OOh 

<C 

- 

busy 

IBC] 

FIFO/Tr address 

m 

IDEI 

FIFO/Re address 

m 

IHLl 

- 

t 


I This SV-call includes the function of S-OC (initialize MIDI port). 

If this is used in operating mode 1.1, the effect is same as that of 
S-OC call. 


2 The size of FIFO buffer is 1 OOh bytes each for FIFO/Tr and FIFO/Re. 

3 FIFO/Tr or F!FO/Re will be cancelled if OOOOh is specified as FIFO 
address. 

4 Interrupt RiRDY IRQ is enabled only while FIFO/Re is defined. 

5 Interrupt TiRDY IRQ is enabled only while FIFO/Tr is defined. 
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S- 09 


Assign channel 


(This allocates the channels of the FM sound generator 1C for the 
requesting 1DB). 


Entry address: 

009Ch 


Registers: 

in 

out 

I A] 

09h 

ooh 

<o 

- 

busy 

IBC] 

ch 8 0 to 3 

m 

IDE1 

ch»4to7 

* 

IHL1 

_ 

■ 


1 IBC1 

luxxyyyyzzzztttt] 

xxxx=0 - 7 ; IDB 8 assigned to channel 0 
yyyy=0 - 7 ; IDB 8 assigned to channel 1 
zzzz* 0 - 7 ; IDB 8 assigned to channel 2 
tttt= 0-7 ; IDB 8 assigned to channel 3 
IDE] 

Ippppqqqqrrrrssss] 

pppp=0 - 7 ; IDB 8 assigned to channel 4 
qqqq=0 - 7 ; IDB 8 assigned to channel 5 
rrrr= 0 - 7 ; IDB 8 assigned to channel 6 
ssss= 0 - 7 ; IDB 8 assigned to channel 7 

2 IDB 8 8h - Fh are reserved for future usage. 

3 Assigning a channel will not alter the previous settings of the LFO. 
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S-OA 


Assign IDB to Queue and/or MIDI channel 


(This assigns the corresponding input Queue and MIDI output channel 
to the designated IDB). 


Entry address: 

009Ch 


Registers: 




in 

out 

[A] 

OAh 

ooh 

<o 

- 

busy 

IBC] 

IDB#/- 

* 

IDE] 

Queuelink/MIDIlink 

a 

IHL] 

- 

a 


1 Queuelink ID] 

llOOOOxix] in* 0 - 7 ; QU“ 

MIDIIink [E] 

(xOOOyyyy] i=<1> ; MIDI is assigned 

x=<0> ; MIDI is not assigned 
yyyy=0 - Fh ;M1DI channel 0 


2 When this call is issued, an All-Note-Off event will be executed 
for the corresponding IDB. 


3 Only MIDI channel (without using any channel of FM LSI) can be 
assigned. 
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S - OB All-Note-Off by IDB 


{This issues and executes an All-note-off to designated IDB). 

Entry address: 

009Ch 


Registers: 

in 

out 

(A) 

OBh 

ooh 

<C> 

- 

busy 

IBCJ 

IDB*/- 

a 

IDE] 

- 

a 

(HL1 

- 

a 


1 IDB* |B] 

lOOOOOml xn= 0 - 7 ;IDB# 


i no * 
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S - OC Initialize MIDI 


(This initializes the MIDI port). 

Entry address: 

009Ch 



Registers: 

i 

in 

out 


IA1 

OCh 

ooh 

-• 

<C> 

- 

busy 


1BC| 

- 

» 


IDE1 

- 

* 


IHL] 


m 



1 In operating mode 1.0/1.1, this routine disables both the RxRDY and 
TxRDY interrupts of MIDI. 

Thus in operating mode 1.0/1.1, MIDI is driven only under non- 
interrupt condition. 
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S-OD Enable/disable OPM interrupt 


(This allows the user to freely control the interrupts of clock-A/B) 

Entry address: 

009Ch 


Registers: 

in 

out 

[A] 

ODh 

ooh 

<o 

- 

busy 

IBC] 

-/mode 

t 

IDE] 

- 

ft 

IHL] 

“ 

ft 


1 Mode [Cl 

lOOOOOOyx] x=l ;enable clock-A 
y=l ;enabie clock-B 
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S-OE Select U1SV priority mode 

(This selects polling priority mode of U1SV in operating mode 2 6T 


Entry address: 

009Ch 


Registers: 

in 

out 

[A] 

OEh 

ooh 

<C> 

- 

busy 

iBd 

-/mode 

* 

IDE] 

- 

s 

IHL) 

- 

« 


1 Mode IC] 

10000000x1 i=0 MIDI > clock-A > clock-B > VDP 

x=l MIDI > clock-B > clock-A > VDP 


f tl?l 
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S- 10 


Set Brilliance 


(This sets the system parameter , Brilliance). 


Registers: 

in 

out 

!A] 

1 Oh 

ooh 

<C> 

- 

busy 

1BC] 

-/Brilliance 

« 

IDE) 

- 

1 

IHL) 

- 

* 


1 Brilliance 1C) 

Ixxxxxixx) iiixirxx = OOh (dark) to 

FFh (brightest) 


System 6 nS»"«ii S , a S> ' S ^ m P arametef - affects the whole 
system, not merely a single instrument. 
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S-11 Set pitchbend 

(This sets the system parameter, pitchbend). 


Registers: 



in 

out 

[A] 

llh 

ooh 

<C> 

- 

busy 

[BC] 

-/Pitchbend 

s 

IDE] 

- 

* 

IHLl 

- 

• 


1 Pitchbend [C] 

Ixxxixxixl iiixxixx = -128 to *127 (2's complement) 
xxxxxxxx « OOh OX 

80h(-128) -100X 
7Fh(127) *100* 

2 As in portamento, to realize pitchbend, an R-19 call (updating KC 
information) should be repeatedly issued in syncronization to each 
A-clock interrupt. 
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S - 12 Define Play-mode 


{This sets the performance mode of the designated IDB (by the FM 

sound generator 1C).} 


Registers: 



in 

out 

IA) 

12h 

ooh 

<o 

- 

busy 

IBC] 

IDB*/Mode 

* 

IDE1 

- 

m 

IHLJ 

- 

* 


1 IDB* IB) 

IOOOOOixi] ni=0-7; IDB* 


2 Mode 1C] 

IOOOOtzyx] x=<l> 

y=<]> 

y=<0> 

z=<l> 

z=<0> 

1 =< 1 > 

t=<0> 


sustain on 
single triggered 
multiple triggered 
full portamento 
fingered portamento 
disable pitchbend 
enable pitchbend 
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S-13 Set Volume 

{This sets the Volume of the designated 1DB). 


Registers: 



in out 

IA1 

13h ooh 

<o 

busy 

1BC] 

lDB°/Volume 

[DEI 

* 

[HL] 

■ 


1 


1DB° IB] 

[OOOOOxxx] 


2 Volume [Cl 

Ixxxxxxxxl 


XXI=0 - 7 ; 1DB° 

xxxxxxxx= OOh (min) to 
FFh (max) 
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S-14 Load Voice 


(This loads the voicing parameter information of designated 1DB 
into the FM sound generator IC). 


Registers: 

in 

out 

IA! 

14h 

ooh 

<o 

- 

busy 

[BCJ 

IDB*/- 

m 

IDE] 

- 

s 

IHLJ 

- 

t 


1 1DB* IB] 

lOOOOxin) m=0 - 7 ; IDB* 
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S - 15 Get Voice 

(This transfers voicing parameter information from the Voice 
library to the voicing parameter area of the designated IDBJ. 

Registers: 

IA1 
<C> 

IBC1 
IDE] 

IHL] 

1 1DB ” > B 1 

lOOOOOxxxl xxx=0 - 7 ;IDB # 

7 Voice* IC1 

Iiiiimi] xxxxiiix=00h - 2Fh for SVL 

4oh - 6Fh for UVL 

3 The transfer will be ignored if the UVL has not been defined. 


in out 

15h ooh 

busy 

IDB s /Voice* m 
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S - 16 Put Voice 

(This transfers the voice parameter information from the IDB to 
the UVL.) 

Registers: 

IA1 
<C> 

IBCJ 
I DEI 
IHL1 


1 IDB 0 [B] 

100000m] in* 0 - 7 ;IDB° 

2 Voice 0 IC] 

[xiiixiii] xxxxxxxi* OOh - 2Fh for SVL 
40h - 6Fh for UVL 

3 The transfer will be ignored if the UVL has not been defined. 


in 

out 

16h 

ooh 

- 

busy 

IDB°/Voice° 

« 


* 
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S-17 Set stereo L/R 

(This sets L/R control of currently engaged voice with 1DB) 


Entry address: 

009Ch 


Registers: 

in 

out 

IA] 

17h 

ooh 

<C> 

- 

busy 

IBC1 

IDB s /data 

* 

IDE] 

- 

* 

[HLl 

- 

« 


1 data [Cl 

[yxOOOOOOl i=l ;enable left 

y= 1 ;enable right 
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S-18 Setpms/ams 

(This sets pms/ams to currently engaged voice with IDB) 


Entry address: 

009Ch 


Registers: 

in 

out 

[A] 

18b 

ooh 

<o 

- 

busy 

IBC1 

IDBVdata 

* 

[DE] 

- 

* 

IHLJ 

- 

> 


1 data [C] 

lOyyyOOxx] xx pms 

yyy ams 
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S-19 Get & load voice 


[This gets and loads voice into channels hooked up with 1DB. 
Same as issuing S-H after S-15). 


Entry address: 

009Ch 


Registers: 

in 

out 

[A] 

19h 

ooh 

<C> 

- 

busy 

IBCJ 

IDB*/voice* 

* 

IDE] 

- 

s 

IHLJ 

- 

* 
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S-20 File Driver 


Entry address: 

009Ch 


Registers: 

in 

out 

[A] 

20h 

error location 

<C> 

- 

error 

IBC] 

- 

-/error status 

IDE] 

control block address 

X 

IHLl 

- 

X 

[Alternate Rgs] 


destroyed 


1 This call should not be issued in UISV. 


2 Control block specification 
-17 byte control block 

.byte access code* 

OOh- read file 

01h= write file 

02h- read UVL 

03h= write UVL 


.byte device* 

OOh- CMT 

10h= s/ram (data cartridge) 

20h« default disk drive 

21h= A: 

22h* B: 


word buffer address for access code* OOh/Olh 

word buffer size for access code»00h/01h 

.blkb 8 (8 byte file name string) 

device*00h & access eode*0/I —6 characters 
device*00h L access code*2/3 -- “VOICE" used by MBIOS 
device* 1 Oh — not used 
device*20h/21h/22h — 8 characters 


.blkb 3 (3 byte file name eitension) 

device*00h — not used 
device* 1 Oh — not used 
device*20h/21h/22h — 3characters 

("VOG" as default by MBIOS. 
for acs-code*2/3) 
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3 <C> =1 indicates error has been detected. 

4 Error status (Cl 

Olh- disk i/o error (write protected) 

02h« disk i/o error (drive not ready) 

G3h- disk i/o error (crc error) 

04b- disk i/o error (seek error) 

05h« disk i/o error (record not found) 

06h- disk i/o error (write fault) 

07h= i/o error 

(undefined disk i/o error, 
cmt i/o error, 
s-ram i/o error) 

08h- BDOS error 

09h= invalid parameter 

(invalid access code, device*) 

OAh- invalid file type error 

(invalid BASIC id*, invalid YAMAHA id*) 
0Bh= file body size is larger than buffer 

OCh- DOS is busy 

5 Error location |A] 

Olh- error has occured before physical access 

02h= open error 

03h- read error in BASIC's header file 

04h= read error in file body 

05h- close file error 

06h- create file error 

G7h- write error in BASIC's header file 

08h- write error in file body 
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S - 21 Read UVL 

{This reads in the UVL from the CMT). 


Entry address: 

009Ch 


Registers: 

in 

out 

[A] 

21 h 

error* 

<D 

- 

error 

IBC] 

- 

ft 

IDE] 

- 

ft 

IHL1 

- 

ft 


1 <C>=1 indicates error has been detected. 

Ifso, further information is provided by [A]. 

2 Error" [A] 

Ixxxxxxxx] zxxxxixx-OOh Normal end 

FFh Size Error 

Other non-0* MSX-BASIC error 

3 The file name on the tape is assumed to be "VOICE". 

Search on the tape will be made until "VOICE” is found. 


■4 If UVL has not been defined, error will be flagged out as 
"size" error. 
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S - 22 Write UVL 

(This writes the UVL into the CMT). 


Entry address: 009Ch 

Registers: 

in out 

[A] 22h error* 

<C> - error 

[BC] 

IDE] 

IHL] 


1 <C>=! indicates error has been detected. 
Further information will be provided by (A], 

2 Error* IA] 

liixixixx) iixxxixx-OOh 

non-0* 


Normal end 
MSX-BASIC Error 


3 The file name of the data being written is always assumed to 

be ''VOICE". 

4 Prior to issuing the call, the UVL must have been defined. 

Omission of the UVL could cause the system to crash. 
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S-23 Read EVB 

(This reads in the EVB from the CMT). 


Entry address: 

009Ch 


Registers: 

in 

out 

[Al 

23h 

Error* 

<o 

- 

error 

IBC] 

- 

a 

IDE) 

- 

a 

IHL1 

- 

a 


1 <C>= 1 indicates error has been detected. 

Further information will be provided by [A], 

2 Error* l A] 

Ixiiiiin] xxxxxxxx=00h Normal end 

non-0* MSX-BASIC Error 

3 Prior to this call, a file name must be placed at M.FEVB of M1DB. 
The searching of the filename on the tape will be continuously 
carried out until the file name is found. 

4 If the EVB has not been defined prior to this call, the error will be 
flagged out via size error. 
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S - 24 Write EVB 


(This writes the EVB into the CMT). 

Entry address: 

009Ch 


Registers: 




in 

out 

[A] 

24h 

Error* 

<o 

- 

error 

[BCI 

- 

* 

IDE] 

- 

m 

IHLI 


* 


1 <C>= 1 indicates error has been detected. 

Further information will be provided by [Al. 


2 Error* lAl 

Ixxxxxxxx] xiixxxxx=00h Normal end 

non-0* MSX-BASIC Error 

3 Pries' to this call, a file name must be placed at MJEVB of MIDB. 
The searching of the filename on the tape will be continuously 
carried out until the file name is found. 

4 If the EVB has not been defined prior to this call, the error will be 
flagged out via size error. 
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S - 28 CSM Voicing 


(This will call the CSM vocal synthesis driver). 


Entry address: 

009Ch 


Registers; 

in 

out 

[A] 

28h 

Error* 

<C> 

- 

error 

IBC] 

- 

E 

IDE] 

CSM buffer address 

1 

iHLJ 

- 

t 


1 <C>= 1 indicates error has been detected. 

Further information will be provided by [A], 


2 Error* [A] 

Iiiiiiiii] mxuu-OOh Normal end 

Olh run-time error 


3 


caHmg this command, assign all the channels to the 
IDB“CSM, with voice*46 linked up to it. 


4 In IRQ processing, the control to U1SV (user interrupt service vector) 
will not be granted at all during the CSM processing. 
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4-6 M - call 


M Receive MIDI 

(In operating mode 1.0/1.1, this scans the input port of the MIDI 
interface, and returns the data if there is a data) 

(In operating mode 2.0, data is retrieved from FIFO/Re buffer) 


Entry address: 
Registers: 


IA] 

<C> 

IBC] 

IDE] 


00A5h 


in out 


o 

data/staus 


IHL] - o 


1 


Status [E] 


lOOzyOOiO) 


x 

y 

z 


RxRDY 

Overrun error (op 1.0/1.1) 
FIFO/Re overflow (op 2.0) 
Framing error 
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4-7 F-Call 


F-00 Clear FIFO/Re 

{This clears FIFO/Re buffer and resets error flag } 

Entry address: 

OOBlh 


Registers: 

in out 


IAI 

OOh 


<C> 



IBC] 

- 


IDB1 

* 


IHL] 

* 



1 Error flag is reset. 
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F-01 Qear FIFO/Tf 

(This dears FIFO/Tr buffer) 


Entry address: 

OOBlh 


Registers: 

in 

out 

lAl 

Olh 

m 

<o 

- 

z 

[BC] 

- 

z 

IDE) 

- 

m 

IHL1 


* 


1 Error flag is reset. 
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F-02 Reset Error Flag 

{This resets error flag of MIDI interface register) 

Entry address: 006lh 

Registers: 

IA] 

<0 
IBC| 

IDE] 

IHL] 


in out 

02h 







F-03 Send a byte of MIDI dau 

(This sends a byte of MIDI dau to FIFO/Tr} 
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Entry address: 

OOBlh 


Registers: 

in 

out 

(A) 

03h 

« 

<o 

- 

* 

IBC] 

-/data 

* 

IDE] 

- 

« 

[HLl 

• 

* 

1 This is equivalent to R-21, but is faster. 

2 Normally this is used to send MIDI real lime dau between F8h and 


FFh. 

3 The same care must be taken if a data between OOh and F7h is to be 


trasmitled. 

4 If FIFO/Tr is full, it waits until FIFO/Tr becomes available to send. 

5 If no FIFO is defined, it sends a data directly to MIDI port. 
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4-8 

BDOS-call 

(Disk access routines) 

(Disk access routine) 

Entry address: 

00B4h 

Registers 




in 

out 

[A] 

see BASIC 

status 

<C> 


<0> normal <1> illegal call 

IBCJ 

see BASIC 

see BASIC/substatus 

IDE] 

see BASIC 

see BASIC 

IHL] 

see BASIC 

see BASIC 


1 In operating mode 1.1, interrupt should be disabled before and after 
BDCS-call. 

2 In operating mode 2.0, interrupt can be enabled before the call. If it 
was called with El, call is returned with interrupt being enabled. 

3 MBIOS disables IRQ state in Ih.kei] routine. 

4 Illegal call conditions 

-MBIOS is already performing BDOS-call. 

-Disk does not exist. 

-MBIOS is already performing SV-call or UISV. 

5 Status 

-FEh; disk error (with sub status) 

-other ; see BDOS status manual 

6 Substatus 

<01 h> write protected 

<02/03h> drive not readv (R/W) 

<04/05h> CRC error (R/W) 

<06/07h> seek error (R/W) 

<08/09h> record not found (R/W) 

7 BDOS-call can not be issued in UISV or AST. 
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4-9 AST (Asynchronous System Trap) 


AST - 01 MK trigger 

(This is an AST caused by the trigger from the MIC (Note-on, Note-off)) 

MIDB vector: 

offset 3Ch (m.trmk) 

Registers: 

out 

[A] 

Olh 

<c> 

- 

IBC1 

- 

IDE] 

Event 

IHL] 

- 


1 Event |DE] contains the same event data used in Queue. 

2 To receive this AST control, MK scan OC-01) should be issued 

elsewhere in the program. . .... 

This AST is invoked during the execution of K-01 routine (, iT the 
vector is defined in the MIDB). 

Users however don't have to worry about the synchronicity of 
both (K-01 call and AST-01 handler) routines. 
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AST - 02 Error 


(This is an AST caused by the error generated by MB10S). 

M1DB vector: 

Registers: 

offset m.trer (3Eh) 


out 

IA] 

02h 

<C> 

- 

1BC1 

- 

IDE] 

error*/- 

IHLJ 

- 

1 Error ID] 

[00010m] 

QU* has overflowed. 
xxx= 0-7 ;QU» 

100100000] 

EVB is full (end of recording. 
All-Note-Off issued) 

100100001] 

EVB end is encountered (end of 
playback) 

1001 lixxx] 

MIDI time-out error 
xxix= 0 - Fh ;MIDI channel* 


2 When playback/recording is stopped by usual SV-call, AST 
( 20h and 21h) will not occur. 


October 30, 1985 


4-10 U1SV trap 


(This is an interrupt trap caused by user defined UISV vector) 

M1DB vectors: 

offset 30h (m.i38h) 
offset 32h (m.icka) 
offset 34h (m.ickb) 
offset 36h (m.iund) 
offset 3Ah im.irmd) 

Registers: 


IA1 

stacking count 

<o 

* 

IBC] 

a 

IDE] 

« 

IHL] 

a 

IIX/IY] 

« 


1 In operating mode 2.0, when called via UISV, lA] contains stacking 
count of IRQ's. 

For <m.trmd> call, however, stacking count is not maintained. 

2 In operating mode 1.0/1.1, JMP is used to reach user's routine via 
UISV. 

In operating mode 1.0/1.1, IRQ should not be enabled until RET. 

3 In opearting mode 2.0, CALL is used to reach user's routine via UISV. 
In operating mode 2.0, IRQ should be left enabled. 





date: Oct,26,1985 

Dec,05,1985 


co»ipa t i oi li ty leaena: 

012 Used in ooerating mode 1.0/1.1/2.0 

01 Used in ooerating mode 1.0/1.1 

12 Used in ooerating mode 1.1/2.0 

2 Used in ooerating mode 2.0 

iOe) If used in SF0-01, W3I3S may crash. 

C2e) If used in operating mode 2.0, IB I OS may 

crash. 


Command remains same. However some 
defferenee in usage and meaning exist 





Cl]. List of important memory address 


id area: 


OOSJh "MCiiF.MO" 

00 S&h -- 

00 B7h -- 

OOBih -- 

SrG-01 : 


SFG-05: 


(ASCII S chr.) 

ROM id- 

Hardware types 
Software version* 

OOSSh "MCrlFMO” 

OOSSh . 

0037h ..<00 h>.. 

OOSSh ..<0Xh>.. 

OCSOh "HChFMO" 

OOSSh . 

Q037h ..<00n>.. 

00S3h ..<1Xh>.. 


entry address: 

OOOCh 

ROSLT 

12 

OOUh 

WRSLT 

12 

OOlCh 

CALSLT 

12 

0024h 

EWASLT 

12 

00 2ah 

CALlF 

12(Oe) 

OOBAh 

RD°P.0 

12(0e) 

OOBOh 

EOCNVO 

1 2(0e) 

OOCOh 

EVCNV1 

12(0e> 

0090h 

I-call (1.0) 

012 

00 Aoh 

I-eaU (1.1) 

12(Oe) 

OOAah 

I-caU (2.0) 

12(0e) 

00B7h 

END-call 

1 2( Oe) 

00 A2h 

►"-Monitor 1.0 

012 

OOAch 

M-Monitor 2.0 

12(Oe) 

OOB4h 

BDCS-call 

12(Oe) 

0093h 

R-call 

012 

OO^dH 

K-call 

012 

0099h 

P-call 

012 

009Ch 

S-cal l 

012 

0 0 9 5 h 

•"-call 

012 

OOBIh 

F-calt 

2(0e) 

009Fh 

IRQC 

01 (2e) 

COOoh 

R-ca 11 

12(Oe) 

OOlOh 

S-call 

1 2 ( 0 e) 










C23. List of SV-calls 


i-call: 


R-OU 

Damp 

012 

R-01 

All Note Off (by Queue) 

012 

R-02 

Set event into Queue 

Cl 2 

R- 33 

(reserved) 


R-94 

Set event into Chord-K3 

01 2 

R-Oj 

Set Chord* into Chord-X3 

012 

R-06 

- 


R-07 

- 


R-Oa 

Start Recording 

012 

R-09 

Set Recording Clock 

012 

R-9A • 

Stop Recording 

01 2 

R-Oa 

Start °layback 

012 

S-OC 

Set Playback Clock 

01 2 

R-OJ 

Stop Plavoack 

012 

P-Oc 

(reserved) 


R-Of 

- 


R-10 

Start Auto Rhythm 

012 

R-11 

Set Auto Rhythm Clock 

012 

R-12 

Stop Auto Rnythm 

012 

R-13 

Select Auto Rhythm 3ueue 

012 

R-U 

Select RHd 

012 

R-15 

- 


R-16 

- 


R-17 

- 


R-1 o 

Load L c 0 

012 

R-1 9 

Load KC 

01 2 

R-1 A 

(reserved) 


R-1 a 

(reserved) 


R-1C 

- 


R-10 

(rese rved) 


R-1 c 

- 


R-1F 

- 


R-20 

Sena "MIDI ,message” 

12 

R-21 

Send "MIDI real time message" 

01 2 


'< - c a 11: 


K-Ol) 

Init MX 

012 

K — 01 

Scan MX 

012 

K-32 

s ic:r; MX status 

012 






S-call: 


S-00 

Define 106 

012 

S-01 



S-02 

Define £VB 

012 

S-03 

Define UVL 

012 

S-04 

Initialize £V3 

012 

S-03 

Define FIFO 

12* 

S-Oo 

“ 


S-07 

“ 


S-03 

(reserved) 


S-09 

Assign Channel 

012 

S-OA 

Assign Queue ano MIDI cnannel 

012 

S-0= 

AU Note Off (by ID3) 

012 

S-OC 

Initialize MIDI 

012 

S-OD 

cnasle/3isaole OPM-I'S 

12 

S-0; 

Select UISV priority mode 

2 

S-OF 

- 


S-10 

Set Srilliance 

012 

S-11 

Set Pitchoend 

012 

S-1 2 

Define Play mode 

012 

S-1 3 

Set Volume 

012 

S-14 

Load Voice 

012 

S-15 

Get Voice 

012 

S— 1 6 

Put Voice 

012 

S-1 7 

Set stereo -73 

12 

S-1i 

Set AMS, PM5 

12 

S-19 

Get i Load Voice 

12 

S-1A 

- 


S-1 a 

- 


S-1C 

- 


S-1Q 

- 


S-lc 

- 


S-1F 

- 


c- 20 

c i t 9 cJri ve»* 

12 

S-21 

Seed UVL 

012 

S-22 

Write UVL 

012 

S-2i 

Peao cV6 

012 

S-24 

Write SVO 

01 2 

S-25 

- 


S-26 



S-27 

- 


S-2s 

CSM Voicing 

012 

F-00 

Clear FI"0/3e 

2 (Oe) 

F-01 

Clear PI^O/Tr 

2 (Oe) 

F- 02 

Peset error flag 

2(0e) 

F-03 

Send "real time message" 

2 (Oe) 





C33. ^ID6 comoatibility 


m.sram 

2ohC33 

s/ram size 


12 

m. fa 

2Ahm 

thru ( timer 

—-> F3h ) 

2 



C0000 00--3 

<1> timer/a 

-> MIDKoutO 



COOOO OC*-3 

<1> timer/b 

-> MIOICout) 

m.i38h 

3 0 h C 'J 3 



01 

m.ick a 

32hCM3 



012 

n. ickb 

34hty] 



012 

m.iund 

3 3 h C U 3 



012 

m. trmd 

JAhCWJ 

data exists 

in r IFO/ c 'e 

2 

m. trim 

3ChCW3 

45T*1 


012 



43TS3 


012 

*.trer 

3£b C'J 3 

»ST*2 


01 2 

m.thru 

CW3 

MIDI/thru table 

2 


E3h 

COOOO 000*3 

<1> enable 

Fd h thru 


• • • 

Erh 

C0000 000-3 

<1> enable 

rrh thru 




C4l. memory, slot map 


operating mode 1.0: 


Memory 

map: OOOJh 


SF5-95 rom 

AOOOh - 

7P--h 

user's area 


(pot tan!- 

EdFFh 

interface area 

(195, ’JVL, staeic, ...) 


ECOOh - 

Fj7Fh 

M1D3 S bios' uork 


r330h - 

F974h 

basic warn area 


F975h - 

F? r ih 

bios work area 


F9 c 5h - 

c A c 4h 

user's area 


c A"5h - 

FF--H 

basic work area 

ooerating mode 

1.1/2.9: 



Memory 

map; 000JH • 

3r-Fh 

SFS-05 rom 

4000h - 

7 F r "h 

user's area 


(oottpm)- 

(h i mem) 

interface area 

(HIDE, 103, UVL, stack, ...) 


(himem)- 

F974h 

basic work area 


F975h - 

?9 r| *h 

bios work area 


F9F5h - 

FAF4h 

user's area 


FA"5h - 

FF rr h 

basic work are a 






ailing Sequences (outside of m-aios repertoire) 


Cd3. : 


rdslt: 

see 

basic 

a r s l-t: 

see 

basic 

cals It: 

see 

basic 

enaslt: 

see 

basic 

calif: 

see 

basic 

rdop,0: 

get 

slot* of related address 


<s equence> 

di 

call 



(I33/aisa oled 

wnen returned) 

<interface> 

<in> 

<return> 

Cal 

- 

s lot# 

<c> 

- 

* 

Coed 

- 

* 

Cde3 

- 

, 

Chid 

target address 

* 

C i x / i y 1 

- 

* 


evcnvQ: convert 

ev?nt(opm) -> 

event C M ICI) 

<s equence> 

call OOSjh 


<interface> 

<i n> 

<return> 

Cal 

- 

* 

<c> 

- 

0 

Coc 3 

-/Mim-ch# 

-/1St-byte(9Xh) 

Coe J 

event(kc*/vs l) 

2nd-/3rd-oyte 

CM3 

- 

* 

Ci x3 

- 

0 

Ciy3 

- 

0 


e vcnvl: convert 

event C 1 'IDI) -- 

-> event(opm) 

<s equence> 

call 00C3H 


<interface> 

<1 n> 

<r eturn> 

Ca? 

- 

* 

<c> 

- 

<0> valid <1> invalid messaoe 

Coc3 

-/I st-byt e 

-/MIDI cha 

Cae3 

2nd-/3rd-oyte 

event(kc*/message) 

ChU 

- 

* 

Ci x3 

- 

0 

Ciy3 

- 

0 


. 1st byte of valid message is JXJy oj- 9Xh„ 





ailing sequences (m-bios repertoire) 


Col. 


I-call: initialize m-bios 


<s equence> 

di 

call 

!)0P3h 

(oios 1.0) 



OOSah 

( 1.1) 



OOAoh 

( 2.0) 



/oisaoled 

wnen returned) 

<interface> 

< i n> 


<retum> 

Cal 

- 


* 

<c> 

- 


* 

Coc3 

- 


* 

r Hm'. 

MMJ 

address 

* 

Chii 

- 


* 

C i x / i y 1 



* 

<:1IJ3 5ddress> 

used 

in opera 

ting node 1.1/2 


This routine oerforns the followings. 

. Defines *IDS<7S0h bytes) ana initializes it. 
. Protects oasic's 3 LAY and initializes queue 
Duffer. 

. loads DO 1 - into M'J3:C e (f . 

. reolaces H.PLQYlffc5h) with... 
poo hi 
ret 


iHD-call: escaoe from ra-bios 


<bios 1.1/2.0> di 

call 0037h 

(IPD oisaoled t iml when returned) 


<inte 


rface> 
Cal 
< c > 
Cocl 
Cdel 
Cn 13 


<i n> 


<return> 

w 

* 

* 


Do not issue c^JO-call after ?>ID-call 





M-monitor: 


calL Music Monitor 


M-moni tor 1.0 ... DISK function is not availaole 

2.0 ... DISK function is availaole 


<sequence for M-nonitor 1.0> 


execute 

I-caU 

Cl .0) 


execut? 

S-02 

(define 

EVB) 

execute 

3-03 

(define 

UVL) 

di 

cal l 

OOflch 




(I3'.l bisaoled/ij>1) 
execut* I-;all 
<sequence for M-monitor 2.0> 


execute 

I-eall 

(1.1/2. 

0) 

execute 

S-32 

(define 

E/3) 

execute 

S-33 

(define 

UVL) 

di 

call 

00&ih 




CIRQ disaoled/inl) 

txtcut; I-sa ll 

<interface> <in> 

Ca 2 
<c> 

CbeO 
Cae 3 
ChU 

Ci x/iy3 
Calt.r!3 - 

<me:nory mao> OOOOh - 3F r Fh 

4000h - 7F-Fh 


<return> 

* 

* 

* 

* 

* 

* 

* 

SF3-C5 
user's area 


(bot ton)-(himam) 
(himem)- FF rr h 
...C /SuHo).. 


... MSI03 .naps M-monitor 
program here 
interface area 
basic’s area 
MIDS 


... fixed address (EOCOh-) 
in M-monitor 1.0 

...( C20hS).. UVL 

. evl ... more than 2000h8 

•. stack ... more than 200h3 






3D0S-call: 

execute 

SOOC-call (for 

disk access) 

<oios 

1.1> 

di 

call 0094h 

(I3J oisaoled 

when returned) 

<oi os 

2.0> 

ei 

call 0 0 * 4 h 

(I^a enabled returned) 

<interface> 

<i n> 

<return> 


Cal 

to aasic 

status 


<c> 

. 

<0> normal <1> invalid 

, 

Cocl 

to oasic 

from basic / suo status 


CaeJ 

to oasic 

from basic 


cm: 

to oasic 

from basic 


. !-laIOS uses CH.HiYi:, and restares it after oosration. 


<inva Lis eondition> . 

. when m-sios is already per.ornn, 33-o-i.all 

. disx does not exist. 

. when m-bios is performing SV-caU or uisv. 


<status> 

<feh> disk physical error 
<otne r> bsos's status 


(see suo-status) 


<suo-status> 

<01n> write protected 
<02/03h> drive not ready (9/W) 
<04/05h> C3C error (9/'J> 
<06/07h> seek error (K/J) 
<03/OSh> record not found (3/W) 
< 0 a/ 0 oh> write fault (^/U) 
<0c/0dh> other error (3/W) 






3-cal l: 

<oios 1 • 0/ 1 . 1 > call ~0CP3h~. 

^1^3 disaoled wn*n returned) 

<oi'os 2.0> 

call OO^h 

(I,a enabled whan returned) 

<interface> 

Ca 2 
<c> 

Coc J 
Cdej 
CnlJ 

Ci x/1 yj 


<in> 

op~code» 

o a ra met e r 
Parameter 


<r eturn> 

St atus* 

<0> normal < 1 > error 


<-call: 


<oios 1 .3/1. 1 > di/ei 

call 0096b 

(I^a disaoled/enaoled when returned) 
<oios 2.0> ei 

call 009ih 

(I*J enabled when returned) 


<interf.ace> 

Ca3 

<c> 

CbcJ 
CoeO 
ChU 
Ci x/i y J 


<1 n> 

op-code? 

parameter 

Parameter 


<return> 

00b 

<0> normal <1> bus/ 
* 

* 

* 

3 


•call: 


<=iss 1.0/1. 1 > di/ai 

call 0099b 

<1*0 disaoled/enabled when returned) 

<=ips 2.3> ei 

call 00 3 ?b 

CI90 enabled when returned) 


<inte r face > 

<1 n> 

Ca3 

OOh 

<w> 

_ 

Coc 3 


C dej 

Queue rnao 

ChU 

. 

Ci x / i y 3 

- 


<return> 

00b 

<0> normal < 1 > bus/ 


o 






S-ca 11: 


VcalU 


< oio s 1.0/1.1> 


call 00?Ch 

(I^il disaoled wnen returned) 


<o i os 2.0> 


e i 

call 00<>:h 

enabled when 


<int e rface> 

< i n > 

Ca] 

9p-code» 

<c> 

- 

CocJ 

oarameter 

Cde] 

oa-amet ar 

Chi J 

- 

Cix/iy] 

- 


returned) 

<r*turn> 
st atus* 

<0> nornal <1> error 

Hr 

* 

* 

O 


. Contents of alternative registers are destroyed 
in S-20,S-21,S-22,5-23,S-2i calls. 


scan MlOI/in or FT^C/re 


<oios 1.0/1.1> di 

call 00A5h 

(I?d disaoled when returned) 


<bios 2.0> ei 

call 00A5h 

enabled ahen returned) 


<interface> <in> 

Ca] 

<c> 

r- c n _ 

Coe] 

Chi] 

Ci x/ly] 


<return> 


data/status 

* 

o 


<status> 



<1> fraaing error 
<1> overrun, 

FIF3/re is overflow 
<1> data exist 






call 


<bios 2.0> 

si 

call Q0?1h 



(I^J enablsd ah 

in returned) 

<iriterface> 

<i n> 

<return> 

C a ] 

op-coaerf 

* 

< c > 

- 

* 

Coc] 

oarameter 

* 

Cos] 

Parameter 

* 

ChU 

- 

* 

Ci x/iy] 

- 

0 


I3QC: 


<oios 1.0/1.1> di 

jp/call OO^Fh 

<intsrface> <in> 

Ca] 

<c> 

Coc J 
Cde] 

ChU 
Ci*/i yl 




C73. several SV-calls 


2-20 call: send MIDI message 


<in> <r:turn> 

C a 3 20h OQh 

< c> - <0> 

CocJ buffer site * 

CaeJ buffer address * 

CnU - * 


. You must send one MIDI message by one 9-20 call. 
. If FIF0/ T r is full, it waits. 


9-21 call: sens MIDI real, time * n ess3ge 


<i n> 

C a3 20h 

< e> 

CocJ -/data 

Cde J 
CnU 

<data> 1111 1- <rsh - ^Fh 

. If FIFO/re full, it waits. 


S-05 call: define FIFO/re, FI?3/tr 


<in> <return> 

Ca3 OSh OOh 

<c> - busy 

CbcJ FI^O/Tr aadress * 

CaeJ FIFO/Xe address * 

CnU - * 


. Tnis SV-call includes tne function of S-00 call, ano in 
operating mode 1.1 this SV-call is sane as S-Oc call. 

. The site of fxfq/r« or FI r 0/Tr is lOOn bytes. 

. FIFO/Se or FIFO/Tr is canceled uhen address value is OOOOh. 
. When FIF0/9e is defined, RxSDY 190 is enaoled. 

. When FIFO/-* is not defined, 2x90Y is disabled. 

. When FIFO/Tr is not defined, TxRDY 190 is disabled. 


<return> 

OOh 

<:> 


S-00 call: 


enable/oisable oo.m I°0 


Cal 
<c> 
CocJ 
Coe J 
CnU 


<i n> 
OOh 

-/mode 


<return> 

OOh 

busy 


* 


* 


<.mooe> 0003 00-* 
0000 00 *- 


<1> enaole ctock-A 
<1> enaole clock-3 







3-0£ call: 


select I9u/priority 



<i n> 


<r et um> 



Cal 

0 ch 


00h 



<c> 

- 


busy 

• .. 


Coe] 

-/^ode 


* 



Coel 

- 


* 



CnU 

- 


* 



<moae> 0000 

000* 

<0> 

CMI3I1 -> Cal 

—-> Cb] 

---> Cvdpl 


<1> 

CHI1I1 -> Col 

-> Cal 

—•> Cvdpl 


S- 1 / call: set s 

;;r*; l/r 



Cal 

17H 


<returr.> 

03h 

<c> 

- 


busy 

Cocl 

I03#/da ta 

* 

Cdsi 

- 


* 

Cn 11 

- 


* 

<data> *-00 

0000 

<1> 

enaale /l 

-*00 

00 w 0 

<1> 

/r 


S-1S call: set PMS, AM5 

<i n> 


<return> 

Cal ISh 


OOh 

<c> 


busy 

Cocl ID3*/data 

* 

Cael 


* 

r ft t. 2 


* 

<data> 0*** 00— 

PMS 


o-00»* 

AMS 



3-19 call: 

get 3 load voice ( 

performs after $-15 ) 


<i n> 

<return> 


Cal '9b 

Cub 


<c> 

busy ■ 


Cocl TOSa/voice* 

* 


Cdel 

* 







S—20 call 


file driver (basic's format idS=feh) 



<i n> 

<return> 

Ca] 

20h 

error position 

<c> 

- 

error 

Coc J 

- 

-/error status 

Cae] 

buffer adaress 

* 

ChU 

- 

* 


. Contents of alternate registers are destroyed. 

terror location> 

<01> pre-procedure 
<02> ooe” file 

<03> read basic's heacer file 

<C-> read file body 

<G5> close file 

<06> create file 

<07> write oasic header 

<0?> write file bod/ 

terror status> 

<01> disk i/o error (write protected) 

<02> oisk i/o error (drive not read/) 

<02> oisk i/o error (crc error) 

<04> disk i/o error (seek error) 

<C5> disk i/c error (reoord not found) 
<06> disk i/o error (write fault) 

<37> i/o error 

( undefined dis* error ) 

( c.mt i/o error ) 

( s/ram i/o error ) 

<0S> Ddos error 

<09> invalid parameter error 

( invalid access code-* > 

( invalid device* ) 

<0a> invalid file t/pe error 

( invalid basic's id- ) 

( invalid yamaha's id) 

<0b> file bod/ site is larger tnan ouffer 
<0c> busy, invalid condition 

<ouffer / 17 oytes> 

CvO access code* 

<C0n> read f1 le 
<01h> write file 
<G2h> read UVL 
<03h> write UVL 
Cl) device* <03h> cat 

<10h> s/ram 
< 2 3 n > default drive 
<21n> a: 

<22n> b: 


C23 

buffer 

address (for acces5-code*=0) 

C43 

buffer 

size (for acces3-code*=3) 

Cbl 

fite name 


cmt: 

6 chr. (for acces3-code*=0) 
"VOICE " (fixed for UVL) 


s/ram: 

not used 

n/i 

disk: 

!*. chr. 





cot: not used 
s/ram: not ussd 
disk: 3 cor. 

"VOj" (defauttOOn> for UVL) 




r -00 call: clear 

FI c O/re 


Cal 

<i n> 

00b 

<return> 

< c > 

- 

* 

Cod 

- 

* 

Cael 

- 

ar 

Cnd 

- 

* 

. Clear FIFJ/Re, and reset 

error flag 


r -01 call: dear 

FJFO/tr 



<i n> 

<return> 

ZaZ 

01 h 

W 

<c> 

- 

* 

Cod 

- 

* 

CdeJ 

- 

* 

ChU 

- 

* 


r -02 call: reset 

error flay 



<i n> 

<return> 

Ca] 

02h 

* 

<i> 

- 

* 

Cod 

- 

* 

Cdel 

- 

* 

Cnd 

- 

tr 


F-03 call: 

send MIDI real 

time message 


< i n> 



Cal Q3h 

* 


<c> 

* 


CocI -/data 

* 


Cael 

* 


CnU 

* 


Ci*/iyl 

* 


<aata> 1111 1 


Fob - F.-h 








C31. Difference between SFG-01 and SF"3-05 


t-C- s 


The - f o l lowi ng oifferences are the result of ■•bug-fixed" made on 
tne MoIDS of 5-3-05. 

t ** «. • " 

Load Voice: Clears related I09's voice area (61 bytes) 

at loading time of SVL's voice, automatically. 


SVL data: 


Portamento: 


Resets "load enable oit" if ... 

{?«S*PMD) + (A?'S*AMO> = 3 
Sets 3 into =“S if ?MD=0. 

Sets 0 into A“i if PMDcO. 

enables portamento even if ID’* is not 
same as this IDo's channel*. 


Assign Channel: Loads voice inco TDBrCSM at the assigning 
of channels. 


Noise: 

LFO syne: 
MIDI(out): 


oug-fix for noise function. 

8ug-fix for L e D sync function. 

enables MIDI(out) for tne IDo whicn has 
no 0PM channels. 


Recoroing: 


Recording: 
<<-00> call: 


enable recoroing start even if MSB of 
recording oueuef byte (in R-03) is reset. 

Missing of last event of recorded data 
is now fixed. 

Disables IR3 in <K-C0> call. 


Mil scan: 


Disables TR3 wnile scanning MK. 


BASIC's HOO.C 


I-call: 


Restores HOOK CH.KEYI, H.ERRO) after 
loading or saving into CMT. 

Sets 0 BM Output level .into 5.25do. 


A37: (caution) fou nust not issue any S.'-;3ll 

(except for F-call) in AST. 

ghen queue has overflowed oy 3I05's "set 
event (R-02)", oios issues "all note off 
(R-0f)" for related cueue automatically. 







The following differences are the result of "refine of *1310*3 
specification" of SrG-05. 


slot: enables the ST3S function, even if slot s 0 

is expanded. 

MIDICout): A l l-.'io te-Of f nissaje is now changed 

to work better with OX series. 

C5 r 3-;‘!> ?Xh/"Eh/0Ch (ae.no/on5 

SXh/7Fh/00h (polv/on) 

(S^O-O') 2Xh/AO/C0h (sustain/o-'f) 

3Xh/?6h/Q0h (all note/off) 

all_note_off (3“a-013 <7-C5> damp 

<2-01> damp 
<S*03> damp 

(Sr3-05) <2-00 damp 

<7-01> release (normal key/off) 

<S-0o> release (normal key/off) 




